服装图像标签搜索模型
功能介绍
基于服装图片返回图像中的服装类型、款式信息、工艺类别及置信度信息。
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 用于获取操作API的权限。获取Token接口响应消息头中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 表5 ClothTaggingItemBody Objects |
图像标签的识别结果。 |
dataset_id |
String |
训练数据集ID。 |
参数 |
参数类型 |
描述 |
---|---|---|
confidence |
Dict |
置信度。取值范围:[0,100)。 |
apparel_category |
String |
服装品类。返回的服装类型,属于一级标签,目前包含11种大类,男西服、女西服、男西裤、女西裤、男衬衣、女衬衣、女西裙、女夹克、男夹克、女大衣、男大衣。 |
appearance_tag |
Dict of表6Objects |
外观标签。属于二级标签,外观粗颗粒标签集合。 |
craft_tag |
Dict of表7Objects |
工艺标签。属于三级标签,工艺细颗粒标签集合。 |
location |
Dict |
外观标签和工艺细粒度标签的目标框在原图中的位置。输出左上和右下两个坐标。 |
参数 |
参数类型 |
描述 |
---|---|---|
season_year |
String |
季节年份。 |
occasion |
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 |
中文潘通色号的大色系。 |
参数 |
参数类型 |
描述 |
---|---|---|
back_vent_style |
String |
后背开衩形式。 |
vent_style |
String |
开衩形式。 |
pocket_style |
String |
口袋形式。 |
collar_stand |
String |
领台。 |
collar_style |
String |
领型。 |
placket_button_count |
String |
门襟扣数。 |
front_placket_style |
String |
门襟形式。 |
front_button_count |
String |
前门扣数。 |
skirt_waist_style |
String |
裙腰形式。 |
skirt_pleat_style |
String |
裙褶形式。 |
hem_style |
String |
下摆形式。 |
lower_pocket_style |
String |
下口袋形式。 |
pocket_flap_style |
String |
袋盖形式。 |
chest_pocket_style |
String |
胸袋形式。 |
chest_dart_style |
String |
胸省形式。 |
sleeve_vent_style |
String |
袖花形式。 |
cuff_style |
String |
袖口形式。 |
sleeve_button_style |
String |
袖扣形式。 |
sleeve_style |
String |
袖子形式。 |
belt_style |
String |
腰带形式。 |
pleat_style |
String |
褶皱形式。 |
back_style |
String |
后背形式。 |
shoulder_yoke_style |
String |
肩袢形式。 |
ticket_pocket_style |
String |
票袋形式。 |
front_pocket_style |
String |
前袋形式。 |
patch_fabric_style |
String |
贴布形式。 |
sleeve_placket_style |
String |
袖袢形式。 |
lower_opening_style |
String |
下口形式。 |
patch_pocket_style |
String |
表袋形式。 |
back_pocket_style |
String |
后袋形式。 |
cuff_style |
String |
脚口形式。 |
pant_waist_adjustment |
String |
裤腰调节。 |
pant_waist_style |
String |
裤腰形式。 |
pant_pleat_style |
String |
裤褶形式。 |
waist_dart_style |
String |
腰省形式。 |
skirt_waist_adjustment |
String |
裙腰调节。 |
over_shoulder_style |
String |
过肩形式。 |
back_vent_style |
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"
],
"pantone_color": "红色",
"pattern": "条纹",
"fabric_color": "红色",
"season_year": "AW",
"style": "意式休闲"
},
"craft_tag": {
"collar_style": "戗驳头",
"chest_pocket_style": "正常胸袋",
"front_button_count": "双排四扣二"
},
"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": {
"collar_style": 93,
"chest_pocket_style": 70,
"front_button_count": 91
},
"apparel_category": 98
}
}
]
}
状态码
请参见状态码。
错误码
请参见错误码。