# 服装图像标签搜索模型 #### 功能介绍 基于服装图片返回图像中的服装类型、款式信息、工艺类别及置信度信息。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/productdesc-pangulm/pangulm_01_0020.html)。 #### URI POST /v1/{project_id}/infer-api/proxy/service/{deployment_id}/ 获取URI方式请参见[请求URI](https://support.huaweicloud.com/api-pangulm/pangulm_05_0004.html)。 表1推理接口路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-pangulm/pangulm_05_0021.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | deployment_id | 是 | String | **参数解释：** 模型的部署ID，获取方法请参见[获取模型部署ID](https://support.huaweicloud.com/api-pangulm/pangulm_05_0023.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 用于获取操作API的权限。如[图4](https://support.huaweicloud.com/api-pangulm/pangulm_05_0009.html#pangulm_05_0009__fig10797003103)中响应消息头中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。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表5ClothTaggingItemBody | 参数 | 参数类型 | 描述 | |:---|:---|:---| | confidence | Dict | **参数解释：** 置信度。 **约束限制：** 不涉及 **取值范围：** \[0,100) **默认取值：** 不涉及 | | apparel_category | String | **参数解释：** 服装品类。返回的服装类型，属于一级标签，目前包含11种大类，男西服、女西服、男西裤、女西裤、男衬衣、女衬衣、女西裙、女夹克、男夹克、女大衣、男大衣。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | appearance_tag | Dict of [AppearanceTagObject]Objects | **参数解释：** 外观标签。属于二级标签，外观粗颗粒标签集合。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | craft_tag | Dict | **参数解释：** 工艺类别和对应的具体的工艺名称，属于三级标签，工艺类别和工艺细颗粒标签集合。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | location | Dict | **参数解释：** 外观标签和工艺细粒度标签的目标框在原图中的位置。输出左上和右下两个坐标。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表6AppearanceTagObject | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 } } ] } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0019.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0020.html)。