服装图像标签搜索模型
功能介绍
基于服装图片返回图像中的服装类型、款式信息、工艺类别及置信度信息。
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 用于获取操作API的权限。如图4中响应消息头中X-Subject-Token的值即为Token。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
Content-Type |
是 |
String |
参数解释: 发送的实体的MIME类型。 约束限制: 不涉及 取值范围: 不涉及 默认取值: application/json |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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。
参数 |
参数类型 |
描述 |
---|---|---|
result |
Array of ClothTaggingItemBody Objects |
参数解释: 图像标签的识别结果。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
dataset_id |
String |
参数解释: 训练数据集ID。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
参数 |
参数类型 |
描述 |
---|---|---|
confidence |
Dict |
参数解释: 置信度。 约束限制: 不涉及 取值范围: [0,100) 默认取值: 不涉及 |
apparel_category |
String |
参数解释: 服装品类。返回的服装类型,属于一级标签,目前包含11种大类,男西服、女西服、男西裤、女西裤、男衬衣、女衬衣、女西裙、女夹克、男夹克、女大衣、男大衣。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
appearance_tag |
Dict of AppearanceTagObjectObjects |
参数解释: 外观标签。属于二级标签,外观粗颗粒标签集合。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
craft_tag |
Dict |
参数解释: 工业类别和对应的具体的工艺名称工,属于三级标签,工艺类别和工艺细颗粒标签集合。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
location |
Dict |
参数解释: 外观标签和工艺细粒度标签的目标框在原图中的位置。输出左上和右下两个坐标。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
参数 |
参数类型 |
描述 |
---|---|---|
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 } } ] }
状态码
请参见状态码。
错误码
请参见错误码。