更新时间:2025-07-29 GMT+08:00
分享

服装图像标签搜索模型

功能介绍

基于服装图片返回图像中的服装类型、款式信息、工艺类别及置信度信息。

URI

POST /v1/{project_id}/infer-api/proxy/service/{deployment_id}/

获取URI方式请参见请求URI

表1 推理接口路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,获取方法请参见获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

deployment_id

String

参数解释:

模型的部署ID,获取方法请参见获取模型部署ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。

用于获取操作API的权限。如图4中响应消息头中X-Subject-Token的值即为Token。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

Content-Type

String

参数解释:

发送的实体的MIME类型。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

表3 请求Body参数

参数

是否必选

参数类型

描述

image

String

参数解释:

被检测图片的base64编码。

约束限制:

要求base64编码后大小不超过10M,最短边至少1px,最长边最大10000px,支持JPEG/PNG/BMP/WEBP格式。

取值范围:

不涉及。

默认取值:

不涉及。

confidence

Integer

参数解释:

置信度的阈值。

约束限制:

不涉及。

取值范围:

[0,100)

默认取值:

40

max_entity_count

Integer

参数解释:

最多返回的实体数(最多10个,最少为1个)。

约束限制:

不涉及。

取值范围:

[1,10]

默认取值:

5

fully_mode

Integer

参数解释:

是否开启全量二级标签展示模式,即打开全量工艺二级标签展示模式,输出全量的二级标签结果,不属于检测到的对应服装品类的二级标签字段也会输出,只是其结果为空字符串。如果需要仅输出属于对应服装品类的工艺二级标签,可以设置为0。

约束限制:

不涉及。

取值范围:

[0, 1]

默认取值:

1

响应参数

状态码: 200

响应成功返回的结构体是一个Dict。

表4 响应Body参数

参数

参数类型

描述

result

Array of ClothTaggingItemBody Objects

参数解释:

图像标签的识别结果。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

dataset_id

String

参数解释:

训练数据集ID。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表5 ClothTaggingItemBody

参数

参数类型

描述

confidence

Dict

参数解释:

置信度。

约束限制:

不涉及

取值范围:

[0,100)

默认取值:

不涉及

apparel_category

String

参数解释:

服装品类。返回的服装类型,属于一级标签,目前包含11种大类,男西服、女西服、男西裤、女西裤、男衬衣、女衬衣、女西裙、女夹克、男夹克、女大衣、男大衣。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

appearance_tag

Dict of AppearanceTagObjectObjects

参数解释:

外观标签。属于二级标签,外观粗颗粒标签集合。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

craft_tag

Dict

参数解释:

工业类别和对应的具体的工艺名称工,属于三级标签,工艺类别和工艺细颗粒标签集合。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

location

Dict

参数解释:

外观标签和工艺细粒度标签的目标框在原图中的位置。输出左上和右下两个坐标。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表6 AppearanceTagObject

参数

参数类型

描述

season_year

String

参数解释:

季节年份。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

occasion

String

参数解释:

场景。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

gender

String

参数解释:

款式性别。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

style

String

参数解释:

风格。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

fabric_color

String

参数解释:

面料颜色。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

pattern

String

参数解释:

花型。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

pantone_no

Array of String

参数解释:

top 3的潘通色号。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

pantone_cn

Array of String

参数解释:

top 3的中文潘通色号。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

pantone_color

String

参数解释:

中文潘通色号的大色系。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求示例

简单场景请求示例

{ 
   "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...", 
 }

带高级参数的多标签分类请求示例

{ 
   "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...", 
   "max_entity_count" : 5, 
   "confidence" : 20,
   "fully_mode": 0
 }

响应示例

{   "dataset_id": "1341002014632579072",
    "result": [
        {
            "apparel_category": "西服上衣",
            "appearance_tag": {
                "pantone_no": [
                    "#7D2027",
                    "#252629",
                    "#482A2B"
                ],
                "gender": "女",
                "pantone_color": "红色",
                "pattern": "条纹",
                "fabric_color": "红色",
                "season_year": "AW",
                "style": "意式休闲"
            },
            "craft_tag": {
                "前片形式": "常规前片",
                "大身廓形": "直筒H型",
                "大身结构": "两开身分割结构"
            },
            "location": {
                "apparel_category": [
                    [
                        1678,
                        1564,
                        2620,
                        3038
                    ]
                ],
                "craft_tag": {
                    "collar_style": [
                        [
                            1868,
                            1563,
                            2400,
                            2340
                        ]
                    ],
                    "chest_pocket_style": [
                        [
                            2258,
                            1905,
                            2428,
                            1989
                        ]
                    ],
                    "front_button_count": [
                        [
                            2028,
                            2330,
                            2266,
                            2638
                        ]
                    ]
                }
            },
            "confidence": {
                "appearance_tag": {
                    "pantone_color": 99,
                    "pattern": 62,
                    "fabric_color": 99,
                    "season_year": 99,
                    "style": 99
                },
                "craft_tag": {
                    "前片形式": 93,
                    "大身廓形": 70,
                    "大身结构": 91
                },
                "apparel_category": 98
            }
        }
    ]
}

状态码

请参见状态码

错误码

请参见错误码

相关文档