Productai

时尚分析服务

时尚智能分析服务可对用户所提交图片中与时尚元素相关的内容进行分析，分析包含：

  1. 找出图中的服饰商品，这些商品的类型及颜色成分；
  2. 判断出图中的服饰、人物所包含的服装款式、图案花型等时尚元素，并以标签的形式返回。

调用说明

Python

PHP

Java

C#

cURL

from productai import Client

cli = Client(ACCESS_KEY_ID, SECRET_KEY)

# 获取对应的服务API
api = cli.get_api('dressing', '_0000111')

# 使用URL作为参数调用API
resp = api.query('https://yyyy')

# 或者使用本地文件作为参数调用API
with open("zzzz.jpg", mode='rb') as search:
    resp = api.query(search)
use ProductAI;

// 获取对应的服务API
$product_ai = new ProductAI\API(ACCESS_KEY_ID, SECRET_KEY, 'zh-Hans');

// 使用URL作为参数调用API
$result = $product_ai->classifyImage('dressing', '_0000111', 'https://yyyy');

// 或者使用本地文件作为参数调用API
$result = $product_ai->classifyImage('dressing', '_0000111', '@zzzz.jpg');
import java.io.File;
import cn.productai.api.core.*;
import cn.productai.api.core.enums.*;
import cn.productai.api.pai.entity.classify.*;

// 设置API调用初始化参数
IProfile profile = new DefaultProfile();
profile.setAccessKeyId(ACCESS_KEY_ID);
profile.setSecretKey(SECRET_KEY);
profile.setVersion("1");
profile.setGlobalLanguage(LanguageType.Chinese);
IWebClient client = new DefaultProductAIClient(profile);

// 使用URL作为参数调用API
ClassifyByImageUrlRequest request = new ClassifyByImageUrlRequest(ServiceType.Dressing, "_0000111");
request.setUrl("https://yyyy");

// 或者使用本地文件作为参数调用API
ClassifyByImageFileRequest request = new ClassifyByImageFileRequest(ServiceType.Dressing, "_0000111");
request.setImageFile(new File("zzzz.jpg"));
request.setLanguage(LanguageType.Chinese);

ClassifyResponse response = client.getResponse(request);
String json = response.getResponseJsonString();
using MalongTech.ProductAI.Core;
using MalongTech.ProductAI.API.Entity;

IProfile profile = new DefaultProfile
{
    Version="1",
    AccessKeyId=ACCESS_KEY_ID,
    SecretKey=SECRET_KEY,
    GlobalLanguage=LanguageType.Chinese
};
var client = new DefaultProductAIClient(profile);

// 使用URL作为参数调用API
var request = new DressingClassifyByImageUrlRequest()
{
    Url="http://yyyy",
    Language=LanguageType.Chinese
};

// 或者使用本地文件作为参数调用API
var request = new DressingClassifyByImageFileRequest()
{
    ImageFile=new System.IO.FileInfo(@".\zzzz.jpg"),
    Language=LanguageType.Chinese
};

var response = client.GetResponse(request);
# 使用URL作为参数调用API
curl -X POST \
    -H 'x-ca-version: 1.0' \
    -H 'x-ca-accesskeyid: ACCESS_KEY_ID' \
    -d "url=https://yyyy" \
    https://api.productai.cn/dressing/_0000111

# 或者使用本地文件作为参数调用API
curl -X POST \
    -H 'x-ca-version: 1.0' \
    -H 'x-ca-accesskeyid: ACCESS_KEY_ID' \
    -F "search=@zzzz.jpg" \
    https://api.productai.cn/dressing/_0000111

输入参数说明

参数名称类型说明必选限制
url字符串Query图片的链接是与search参数二选一
search文件Query图片文件内容是与url参数二选一

输出字段说明

200 HTTP状态码

服务器端成功处理，并返回结果

{
    "is_err": 0,
    "labels": [
        "都市休闲",
        "夏装/秋装",
        "橘黄",
        "纯色",
        "现代",
        "连体裤",
        "白"
    ],
    "labels-en": [
        "Summer clothing/Autumn clothing",
        "Modern",
        "jumpsuit-romper",
        "Pure",
        "Orange",
        "White",
        "casual"
    ],
    "request_id": "aa28df18-e0bb-11e7-9a73-92019f9dce87",
    "results": [
        ... 
    ],
    "time": 2.163
}
结果字段类型说明
is_err整数　１表示有错误，0表示没有错误
request_id字符串本次调用的唯一ID，可以用于和ProductAI团队进行联调分析
results数组图片单品时尚分析结果，详情参见Results字段内信息描述
labels数组中文时尚标签
labels-en数组英文时尚标签

Results字段内信息描述

{
    "box": [
        0.30526315789473685,
        0.16157894736842104,
        0.4112280701754386,
        0.7268421052631578
    ],
    "colors": [
        ... 
    ],
    "item": "连体裤",
    "item-en": "jumpsuit-romper",
    "textures": [
        "纯色"
    ],
    "textures-en": [
        "Pure"
    ]
}
结果字段类型说明
box数组检测出的商品在图片中的位置。格式为”x-y-w-h”。其中x,y,w,h 四个子参数的含义为：以待检测图片左上角位置为坐标（0,0），右下角位置为（1,1），x 为所框选框体左上角横坐标与图片宽度的比值，y 为所框选框体左上角纵坐标与图片高度的比值，w 为所框选框体宽与图片宽度的比值，h为所框选框体高与图片高度的比值。
colors数组颜色分析结果。详情参见Colors字段内信息描述
item数组中文单品类别标签
item-en数组英文单品类别标签
textures数组中文纹理标签
textures-en数组英文纹理标签

Colors字段内信息描述

{
    "basic-cn": "白",
    "basic-en": "White",
    "ncs": "0300-N",
    "percent": 0.89457,
    "rgb": [
        240,
        240,
        240
    ],
    "w3c-cn": "幽灵白",
    "w3c-en": "GhostWhite"
},
{
    "basic-cn": "橘黄",
    "basic-en": "Orange",
    "ncs": "2020-Y60R",
    "percent": 0.10543,
    "rgb": [
        205,
        171,
        149
    ],
    "w3c-cn": "深鲑鱼红",
    "w3c-en": "DarkSalmon"
}
结果字段类型说明
basic-cn字符串中文颜色Basic体系名称
basic-en字符串英文颜色Basic体系名称
w3c-cn字符串中文颜色w3c体系名称
w3c-en字符串英文颜色w3c体系名称
ncs字符串颜色ncs体系名称
percent浮点数颜色比例
rgb数组RGB颜色码

颜色体系请参考这里

非200 HTTP状态码

服务器端遇到错误

{
    "data": {
        "is_err": 1,
        "message": "Download image failed.",
        "request_id": "de5f84d0-e0bb-11e7-91d5-72f17f92a514",
        "time": 0.011
    },
    "status": 408
}
结果字段类型说明
data字典所有信息包装到data中
status整数　HTTP状态码
is_err整数　１表示有错误，0表示没有错误
message字符串错误信息详情
request_id字符串本次调用的唯一ID，可以用于和ProductAI团队进行联调分析
time浮点数服务器端计算时间

错误信息说明

SDK/API使用http状态码来通知客户端本次调用成功和失败

http状态码error_code说明
200N/a数据提交成功
400N/a参数loc不符合规范，或Query图片为空
408N/aQuery图片下载失败，或Query图片格式解析失败，或图片颜色分析失败，或上游计算服务超时

标签列表

中/英文

labels字段包含的可能值列表

中文English
A字宽松裙A_line_loose_dressPolo衫Polo_shirtT恤衫Tshirt包臀半裙Slim_bottom_skirt
保暖Warm背带裤Suspender pants背带裙Suspender skirt长袖连衣裙Longsleeve_dress
衬衫Shirt_blouse衬衫裙Shirt_dress冲锋衣Sports_jackets春装/夏装Spring_summer_season
搭配推荐Style_recommendation打底/吊带背心Tank_strap_tops大摆半裙Volumn_skirt大衣款Coat
单肩包/手提包Shoulder_handbag冬装Winter_clothing斗篷披风Cape_coat都市休闲Urban_casual
都市优雅Urban_elegance度假Holiday短裤Shorts短靴Booties_short_boots
帆布鞋Canvas_shoes风衣Trenchcoat复古/民国Vintage/retro干练Experienced
高跟凉鞋Heel_sandals古典Classical逛街Outdoor_shopping户外小包Outdoor_packet
户外运动Active/athletic活力Energetic夹克Jacket家居Leisure_wear
减龄Youth紧身裙Bodycon_dress经典百搭Classic_style居家Leisure_wear
聚会Social_event/party开衫款Cardigans开学必备School_season可爱Cute
阔腿裤Culotte_pants礼服和婚纱Formal_dress连体裤Jumpsuit_romper旅游Travel
毛呢大衣Wool_coat棉服Padded_jacket牛仔裤Long_jeans暖冬美搭Warm_winter
皮草Fur皮鞋/乐福鞋Leather_loafer_shoes皮衣Leather平底凉鞋Flat_sandals
坡跟鞋/厚底鞋Wedge_shoes旗袍Chinese_dress钱包Wallets浅口高跟鞋Pumps
青春Youth清纯Innocent秋冬Fall_winter_season秋装/早春Fall/spring_season
实用Practical收腰连衣裙Waisted_dress手拿包Clutch淑女Feminine
双肩包Backpacks随性Casual套头衫Pullover_tops通勤Office_lady
拖鞋Slippers外出Outdoor外套背心Outerwear_vest卫衣Hoodies
无袖衫Sleeveless_tops舞会派对Ball_party西装Blazers西装裤Tailored_pants
夏装Summer_season夏装/秋装Summer_season显高Tall显气质Graceful
显瘦Skinny现代Modern小脚紧身裤Slim_pants_leggings性感Sexy
休假Vacation休闲裤Leisure_pants休闲裙Leisure_dress修身Slim_fit
雪地靴Snow_boots雪纺衫/真丝衫Chiffon_tops羊毛衫Wool_sweater_tops泳装Swim_suits
优雅Elegant优雅/淑女Feminine雨靴Rainboots羽绒服Down_jacket
约会Dating运动鞋Sneakers早春/初秋早春/秋冬
早春/早秋Fall/spring_season早秋/冬装Fall_winter_season针织衫/镂空衫Knit_hollow_out_tops知性Intellectual
知性/淑女Feminine职场商务Business_attire中长靴Mid_long_boots商务休闲Business_casual
社交Social时尚平底鞋Flats_shoes

item字段包含的可能值

中文English
中长靴Mid_long_boots卫衣HoodiesPolo衫Polo_shirt坡跟鞋/厚底鞋Wedge_shoes
连体裤Jumpsuit_romper皮鞋/乐福鞋Leather_loafer_shoes帆布鞋Canvas_shoes雨靴Rainboots
风衣Trenchcoat无袖衫Sleeveless_tops衬衫裙Shirt_dress大摆半裙Volumn_skirt
平底凉鞋Flat_sandals旗袍Chinese_dress双肩包Backpacks背带裤Suspenderpants
单肩包/手提包Shoulder_handbag羊毛衫Wool_sweater_tops高跟凉鞋Heel_sandals牛仔裤Long_jeans
背带裙Suspenderskirt羽绒服Down_jacket户外小包Outdoor_packet棉服Padded_jacket
浅口高跟鞋Pumps包臀半裙Slim_bottom_skirt运动鞋Sneakers开衫款Cardigans
短靴Booties_short_boots收腰连衣裙Waisted_dress外套背心Outerwear_vest短裤Shorts
阔腿裤Culotte_pants泳装Swim_suits休闲裙Leisure_dress西装Blazers
小脚紧身裤Slim_pants_leggingsA字宽松裙A_line_loose_dress斗篷披风Cape_coat针织衫/镂空衫Knit_hollow_out_tops
紧身裙Bodycon_dress套头衫Pullover_tops拖鞋Slippers时尚平底鞋Flats_shoes
休闲裤Leisure_pants衬衫Shirt_blouse皮草Fur皮衣Leather
冲锋衣Sports_jackets雪纺衫/真丝衫Chiffon_tops西装裤Tailored_pants长袖连衣裙Longsleeve_dress
夹克JacketT恤衫Tshirt手拿包Clutch毛呢大衣Wool_coat
礼服和婚纱Formal_dress雪地靴Snow_boots打底/吊带背心Tank_strap_tops大衣款Coat
钱包Wallets

texture字段包含的可能值

中文English
条纹Stripe几何图案Geometric格子Plaid字母图案Letters
动物Animals迷彩Camo人物Human花朵Floral
小碎花Printing拼色Contrast卡通Cartoon波点Polkadots
豹纹Leopard纯色Pure