接口列表

本节包含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
  • 返回码

参见 公共返回码

results matching ""

    No results matching ""