时尚搭配
I、 搭配生成
一、接口描述
1. 功能描述
本API可以根据输入的服饰图片,给出若干套与此服饰搭配的商品组合,如下图所示。
2. 能力说明:
本API的核心算法模块为服饰商品图之间的“视觉相搭性”特征模型,能够衡量两件服饰之间的搭配关系。给定一件商品的图片后,本API会从海量商品池中召回与此商品视觉搭配性最高的若干套搭配,例如,给定一件短袖,可以推荐与之搭配的裤子和鞋子;给定一件连衣裙,可以推荐与之搭配的鞋子和包。搭配的类目范围包括:裙装、上衣、下衣、鞋靴和箱包。
3. 接口数据要求:
- 图片格式:base64编码
- 图片大小:不超过10MB
- 图片类型:JPG(JPEG)
- 图片必须为RGB三通道
- 建议输入的图片为商品白底图(如下图所示),若图片中除商品外包含其它背景或模特等,会在一定程度上影响搭配的效果
4. 接口使用:
平台为每个API提供试用体验服务,您在AI市场选择“免费试用”规格下单后,即可开始体验业内领先的人工智能API服务。 免费试用服务具有调用量、QPS限制,如需更高性能的API服务,可以提交咨询工单,联系京东AI扩容购买。
在获得使用权限后,您可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程
二、请求说明
1. 接口地址 :
https://aiapi.jd.com/jdai/recommend_outfits
2. 请求方式:
POST
3. 请求参数
(1)query请求参数
公共请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
appkey | string | 是 | 80d2b762ecb86593f9668526920f46c | 您的appkey,可在买家中心控制台中获取 |
timestamp | long | 是 | 1541491668060 | 请求的时间戳,精确到毫秒,timestamp有效期5分钟 |
sign | string | 是 | 2e148773a0337a8f2200ba90d445f083 | 签名,根据规则MD5(sectetkey+timestamp), |
(2)header请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
Content-Type | string | 是 | application/x-www-form-urlencoded | 标准编码格式,数据以名称=值的方式进行编码 |
(3)body请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
image | string | 是 | 图像Base64编码值,去掉图片头"data:image/png;base64,",仅上传后面部分"/9j/4AAQSk..."(由于过长,不给出示例) | 图像Base64编码 |
outfit_num | int | 否 | 10 | 期望输出的搭配数量,默认为5, 最大值为10, 最小值为1 |
4、请求代码示例
建议您使用我们提供的SDK进行调用,SDK获取及调用方式详见本页一接口描述中的4接口使用
三、返回说明
1、返回参数
(1)公共返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | string | 1000 | 参见下方错误码-系统级错误码 |
charge | boolean | false 或 true | false:不扣费, true:扣费 |
remainTimes | long | 1305 | 剩余调用次数;免费api:每天剩余调用次数;收费api:剩余次数;无限制时为-1 |
remainSeconds | long | 1223456 | 剩余调用时间(s);免费api:-1;收费api:剩余调用时间;无限制时为-1 |
msg | string | 查询成功 | 参见下方错误码-系统级错误码 |
result | object | {...} | 查询结果 |
(2)业务返回参数
result参数信息
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
status_code | int | 0 | 参照四、错误码-业务错误码 |
status_message | string | "sucess" | 参照四、错误码-业务错误信息 |
outfit_list | list | [{...}, {...}..., {...}] | 搭配列表,其中的每一个元素为一组搭配 |
outfit_list中每个元素的参数信息
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
items | list | [{...}, {...}..., {...}] | 搭配商品信息列表 |
score | float | 0.96 | 搭配分数 |
items中每个元素的参数信息
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
image_url | string | https://img14.360buyimg.com/da/jfs/t1/146691/20/8064/60535/5f5a06fcE368dcad9/59c946ff0df426b5.jpg | 商品图片的URL |
item_name | string | 运动鞋 | 商品名称 |
category_id | int | 商品的类别ID, 1-裙装, 2-上衣, 3-下衣, 4-鞋靴, 5-箱包 | |
category_name | string | 商品的类别名称, 裙装, 上衣,下衣, 鞋靴, 箱包 |
2、返回示例
Status Code: 200
Time:550ms
Date:Thu 8 Nov 2018 03:08:40 GMT
Body:
{
"code": "10000",
"charge": false,
"remain": 0,
"msg": "查询成功",
"result": {
"status_code": 0,
"status_message": "sucess",
"outfit_list": [
{
"items": [
{
"image_url": "https://img14.360buyimg.com/da/jfs/t1/146691/20/8064/60535/5f5a06fcE368dcad9/59c946ff0df426b5.jpg"
"item_name": "运动慢跑鞋"
"category_id": 4
"category_name": "鞋靴"
},
{
"image_url": "https://img14.360buyimg.com/da/jfs/t1/128132/8/12097/90775/5f5a0710Eccbc2d7f/b76f22e8325e1adf.jpg"
"item_name": "运动短裤"
"category_id": 3
"category_name": "下衣"
}
],
"score": 0.98
},
{
"items": [
{
"image_url": "https://img14.360buyimg.com/da/jfs/t1/146691/20/8064/60535/5f5a06fcE368dcad9/59c946ff0df426b5.jpg"
"item_name": "运动慢跑鞋"
"category_id": 4
"category_name": "鞋靴"
},
{
"image_url": "https://img14.360buyimg.com/da/jfs/t1/128132/8/12097/90775/5f5a0710Eccbc2d7f/b76f22e8325e1adf.jpg"
"item_name": "运动短裤"
"category_id": 3
"category_name": "下衣"
}
],
"score": 0.96
}
]
}
}
四、错误码
1.系统级错误码
2.业务错误码
业务错误码(status) | 对应message | 说明 |
---|---|---|
10001 | "no image content" | 输入的参数中不包含image |
10002 | "image base64 too large" | 图像的base64大小超过限制 |
10003 | "unable to parse base64" | 图像base64解析错误 |
10004 | "wrong image format" | 错误的图像格式 |
10005 | "outfit num exceeded limit" | 输入的outfit_num参数越界 |
10006 | "cannot find outfits" | 找不到合适的搭配 |
10007 | "no clothes found in input image" | 未在图中检测到服饰搭配所支持的商品 |
Ⅱ、 时尚风格理解
一、接口描述
1. 功能描述
本API可以根据输入的成套服饰搭配图片,对搭配依据不同风格进行打分。
2. 能力说明:
本API的核心算法模块为“搭配风格”分类模型,能判断一套服饰搭配更倾向于哪种风格。 对于给定的一套服饰搭配,本API将判断该套服饰搭配属于“休闲”、“时尚”、“运动”、“职业”哪个大类,并在“约会”、“逛街”、“居家”、“运动”等十个场景中推荐该套搭配最适用的1-3个场景。 例如,给定一套 Admiral大衣 + 彩虹格衫 + 海军蓝休闲裤 + 拼色运动鞋 的搭配,本API返回的风格分类为 休闲,推荐的适宜场景为“潮流”、“逛街”。
3. 接口数据要求:
- 图片格式:base64编码
- 图片大小:单张图片大小不超过3.5MB
- 图片类型:JPG(JPEG)
- 图片必须为RGB三通道
- 输入的图片必须为为商品白底图(如下图所示),若图片中除商品外包含其它背景或模特等,会影响风格分类的准确性
4. 接口使用:
平台为每个API提供试用体验服务,您在AI市场选择“免费试用”规格下单后,即可开始体验业内领先的人工智能API服务。 免费试用服务具有调用量、QPS限制,如需更高性能的API服务,可以提交咨询工单,联系京东AI扩容购买。
在获得使用权限后,您可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程
二、请求说明
1. 接口地址 :
https://aiapi.jd.com/jdai/theme_scorers
2. 请求方式:
post
3. 请求参数
(1)query请求参数
公共请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
appkey | string | 是 | 80d2b762ecb86593f9668526920f46c | 您的appkey,可在买家中心控制台中获取 |
timestamp | long | 是 | 1541491668060 | 请求的时间戳,精确到毫秒,timestamp有效期5分钟 |
sign | string | 是 | 2e148773a0337a8f2200ba90d445f083 | 签名,根据规则MD5(sectetkey+timestamp), |
(2)header请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
Content-Type | string | 是 | application/json | 内容类型 |
(3)body请求参数
业务请求参数
{"images_list":["",""]}
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
images_list | list | 是 | ["",""]每个为一张图像的Base64编码值,去掉图片头"data:image/png;base64,",仅上传后面部分"/9j/4AAQSk..."(由于过长,不给出示例) | 一套服饰搭配的多张商品图像Base64编码,最少2张图,最多不超过6张 |
4、请求代码示例
建议您使用我们提供的SDK进行调用,SDK获取及调用方式详见本页一接口描述中的4接口使用
三、返回说明
1、返回参数
(1)公共返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | string | 1000 | 参见下方错误码-系统级错误码 |
charge | boolean | false 或 true | false:不扣费, true:扣费 |
remainTimes | long | 1305 | 剩余调用次数;免费api:每天剩余调用次数;收费api:剩余次数;无限制时为-1 |
remainSeconds | long | 1223456 | 剩余调用时间(s);免费api:-1;收费api:剩余调用时间;无限制时为-1 |
msg | string | 查询成功 | 参见下方错误码-系统级错误码 |
result | object | {...} | 查询结果 |
(2)业务返回参数
result参数信息
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
status_code | int | 0 | 参照四、错误码-业务错误码 |
status_message | string | "sucess" | 参照四、错误码-业务错误信息 |
outfit_style | string | "休闲" | 输入搭配的风格分类结果 |
style_score | float | 4.8 | 输入搭配的风格适宜性得分(范围0~5,5分为最佳) |
appli_scene | list | [{"校园":4.6},{“约会”:3.7}] | 本套搭配适宜的1-3个场景及得分 |
2、返回示例
Status Code: 200
Time:550ms
Date:Thu 8 Nov 2018 03:08:40 GMT
Body:
{
"code": "10000",
"charge": false,
"remain": 0,
"msg": "查询成功",
"result": {
"status_code": 0,
"status_message": "sucess",
"outfit_style": "休闲",
"style_score": 4.9,
"appli_scene": [{"校园":4.6},{"约会":3.7}]
}
}
四、错误码
1.系统级错误码
2.业务错误码
业务错误码(status) | 对应message | 说明 |
---|---|---|
10001 | "no image content" | 输入的参数中不包含image |
10002 | "image base64 too large" | 图像的base64大小超过限制 |
10003 | "unable to parse base64" | 图像base64解析错误 |
10004 | "wrong image format" | 错误的图像格式 |
10005 | "image num exceeded limit" | 输入的图片数超出限制 |
10006 | "including non-apparel images" | 缺少主要服饰(上衣、下衣) |
Ⅲ、时尚类透/白底图质量筛选
一、接口描述
1. 功能描述
本API可以根据输入的图片是否为正面、清晰、完整且背景透明(或纯白)的时尚类商品,其目的在于检验抠图质量,筛选出适用于商品展示的图片
2. 能力说明:
本API的核心算法模块为“透底图”分类模型,能判断一张时尚类商品图是否为合格、可用于商品展示的透底图。 例如:
3. 接口数据要求:
- 图片格式:base64编码
- 图片大小:单张图片大小不超过3.5MB
- 图片类型:JPG(JPEG)、PNG
- 图片可为RGB三通道,或ARPG四通道
4. 接口使用:
平台为每个API提供试用体验服务,您在AI市场选择“免费试用”规格下单后,即可开始体验业内领先的人工智能API服务。 免费试用服务具有调用量、QPS限制,如需更高性能的API服务,可以提交咨询工单,联系京东AI扩容购买。
在获得使用权限后,您可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程
二、请求说明
1. 接口地址 :
https://aiapi.jd.com/jdai/trans_inspection
2. 请求方式:
post
3. 请求参数
(1)query请求参数
公共请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
appkey | string | 是 | 80d2b762ecb86593f9668526920f46c | 您的appkey,可在买家中心控制台中获取 |
timestamp | long | 是 | 1541491668060 | 请求的时间戳,精确到毫秒,timestamp有效期5分钟 |
sign | string | 是 | 2e148773a0337a8f2200ba90d445f083 | 签名,根据规则MD5(sectetkey+timestamp), |
(2)header请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
Content-Type | string | 是 | application/json | JSON格式 |
(3)body请求参数
业务请求参数(请求数据请使用json格式)
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
image | string | 是 | 去掉图片头"data:image/png;base64,",仅上传后面部分"/9j/4AAQSk..."(由于过长,不给出示例) | 图像Base64编码值 |
4、请求代码示例
建议您使用我们提供的SDK进行调用,SDK获取及调用方式详见本页一接口描述中的4接口使用
三、返回说明
1、返回参数
(1)公共返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | string | 1000 | 参见下方错误码-系统级错误码 |
charge | boolean | false 或 true | false:不扣费, true:扣费 |
remainTimes | long | 1305 | 剩余调用次数;免费api:每天剩余调用次数;收费api:剩余次数;无限制时为-1 |
remainSeconds | long | 1223456 | 剩余调用时间(s);免费api:-1;收费api:剩余调用时间;无限制时为-1 |
msg | string | 查询成功 | 参见下方错误码-系统级错误码 |
result | object | {...} | 查询结果 |
(2)业务返回参数
result参数信息
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
status_code | int | 0 | 参照四、错误码-业务错误码 |
status_message | string | "sucess" | 参照四、错误码-业务错误信息 |
is_transparent | string | "True" | 返回该图片是否为透图 |
confidence | float | 0.96 | 输出是否为透图的置信度 |
2、返回示例
Status Code: 200
Time:550ms
Date:Thu 8 Nov 2018 03:08:40 GMT
Body:
{
"code": "10000",
"charge": false,
"remain": 0,
"msg": "查询成功",
"result": {
"status_code": 200,
"status_message": "sucess",
"is_transparent": "True",
"confidence": 0.96
}
}
四、错误码
1.系统级错误码
2.业务错误码
业务错误码(status) | 对应message | 说明 |
---|---|---|
10001 | "no image content" | 输入的参数中不包含image |
10002 | "image base64 too large" | 图像的base64大小超过限制 |
10003 | "unable to parse base64" | 图像base64解析错误 |
10004 | "wrong image format" | 错误的图像格式 |
10005 | "non-apparel image" | 该图片中不包含服饰类商品 |