接口列表
本节包含AI智能-人体属性识别及人形识别等相关接口
以下接口,返回数据中 msg、 data 不是一定会返回的,但requestId 和 code 是必定会返回
接口列表如下:
序号 | 接口功能 | 描述 |
---|---|---|
1 | 人体属性识别 | 人体属性识别 |
2 | 人形检测 | 人形检测 |
code | msg | 备注 |
---|---|---|
200 | 操作成功 | |
10001 | 参数错误 | |
10002 | accessToken过期或异常 | |
10004 | 用户不存在 | |
10005 | appKey异常 | |
10007 | 调用次数超限 | |
10013 | 无权限调用 | |
10029 | 接口调用太频繁 | |
49999 | 操作异常 | 接口调用异常 |
50000 | 服务器异常 | |
60200 | 非法的服务名 | |
60201 | 确实必传参数或参数校验错误 | |
60202 | 参数解析错误 | |
60203 | 未开通相关服务 | |
60204 | 服务已开通 | |
60205 | 服务内部错误 | |
60206 | 并发数超限 | |
60210 | 图片数据错误 | |
60211 | 图片尺寸错误(太大或太小) | |
60212 | 图片大小超过2M限制 | |
60213 | 下载图片失败 | |
60405 | 图片地址错误 | |
60507 | 服务超时 | |
60508 | 服务器繁忙 | |
60509 | 该功能暂时不支持 |
人体属性识别
接口功能
该接口用于识别用户上传照片中的人体属性信息,包括人体的穿着衣物,其颜色,类型等
请求地址
https://open.ys7.com/api/lapp/intelligence/human/analysis/body
请求方式
POST
子账户token请求所需最小权限
无
- 请求参数
参数名 | 类型 | 描述 | 是否必选 |
---|---|---|---|
accessToken | String | 授权过程获取的access_token | Y |
dataType | int | 数据类型(0:图片URL; 1:base64编码的二进制图片数据) | Y |
image | String | 图片,分辨率范围:50W~900W像素,图片最大2M. 注: 下载图片时可能由于网络等原因导致下载图片时间过长,建议使用image_base64 参数直接上传图片; 不支持对获得的图片数据进行加解密操作 |
Y |
图片大小 800*600 px -- 4096*2160 px (但宽不能大于4096 px 且高不能大于2160 px)
- HTTP请求报文
POST /api/lapp/intelligence/vehicle/analysis/props HTTP/ 1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded
accessToken=at.dunwhxt2azk02hcn7phqygsybbw0wv6p&dataType=1&image=asdfasdfasdfasdfadf
- 返回数据
{
"requestId": "d17ed5583c8a4487a538e47b225beb35",
"data": [
{
"jacetColor": {
"val": "black",
"des": "黑"
},
"ride": {
"val": "no",
"des": "不骑车"
},
"hat": {
"val": "no",
"des": "不戴帽子"
},
"bag": {
"val": "no",
"des": "不背包"
},
"trousersType": {
"val": "longTrousers",
"des": "长裤"
},
"trousersColor": {
"val": "yellow",
"des": "黄"
},
"hairStyle": {
"val": "shortHair",
"des": "短发"
},
"things":{
"val": "no",
"des": "不拎东西"
},
"gender": {
"val": "male",
"des": "男"
},
"rect": {
"x": 202.00038,
"y": 86.00064,
"width": 489.99985,
"height": 980
}
}
],
"code": "200",
"msg": "操作成功"
}
- 返回字段
字段名 | 类型 | 描述 |
---|---|---|
jacetColor | String | 上衣颜色 |
ride | String | 是否骑车 |
hat | String | 是否带帽 |
bag | String | 是否背包 |
trousersType | Map |
下装类型 |
trousersColor | Map |
下装颜色 |
hairStyle | Map |
发型 |
things | Map |
是否拎东西 |
gender | Map |
性别 |
rect | Location | 人体在图片中的坐标 |
- location
Location | Map |
坐标 |
---|---|---|
height | int | 人体在图片中的高度,单位px |
width | int | 人体在图片中的宽度,单位px |
x | int | 人体在图片中左上角的横坐标,单位px |
y | int | 人体在图片中左上角的纵坐标,单位px |
- 返回码
参见 公共返回码
人形检测
接口功能
该接口用于对一张图片的人形分析,给出分析结论及图片中人形的坐标数据
请求地址
https://open.ys7.com/api/lapp/intelligence/human/analysis/detect
请求方式
POST
子账户token请求所需最小权限
无
- 请求参数
参数名 | 类型 | 描述 | 是否必选 |
---|---|---|---|
accessToken | String | 授权过程获取的access_token | Y |
dataType | int | 数据类型: 1-base64编码的二进制图片数据 | Y |
image | String | 待分析的 base64 图片数据,图片数据大小不超过 2M,尺寸最大:1280*1280 |
Y |
operation | String | 默认仅返回是否有人,可选属性列表: number-返回具体人数, rect-返回检测的人形坐标数据,只能二选一 | N |
- HTTP请求报文
POST /api/lapp/intelligence/human/analysis/detect HTTP/ 1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded
accessToken=at.dunwhxt2azk02hcn7phqygsybbw0wv6p&dataType=1&image=asdfasdfasdfasdfadf&operation=number
- 返回数据
{
"requestId": "985610d17fd9473484f53186b317c246",
"data": {
"locations": [
{
"x": 469,
"y": 274,
"width": 141,
"height": 433
},
{
"x": 139,
"y": 289,
"width": 191,
"height": 409
}
],
"exists": true,
"number": 3
},
"code": "200",
"msg": "操作成功"
}
- 返回字段
字段名 | 类型 | 描述 |
---|---|---|
exists | boolean | 是否有人: true-有人, false-无人 |
number | int | 检测出的具体人数 |
locations | Array | 检测出的人形列表,如果没有检测出人形则为空数组 |
- location
Location | Map |
坐标 |
---|---|---|
height | int | 人形框的高度,单位 px |
width | int | 人形框的宽度,单位 px |
x | int | 人形框左上角的横坐标,单位 px |
y | int | 人形框左上角的纵坐标,单位 px |
- 返回码
参见 公共返回码