文档首页/盘古大模型 PanguLargeModels/API参考/API/模型推理接口/图像搜索模型/服装图像标签搜索模型
更新时间：2025-12-01 GMT+08:00
查看PDF
分享

服装图像标签搜索模型

功能介绍

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

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
            }
        }
    ]
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题：图像搜索模型

相关文档