人体姿态类型识别接口

1 引言

1.1 概述

通过http(s)接口的方式实现摄像头抓取jpg图像的人体姿态识别,输出人体姿态类型的结果。

1.2 错误类型定义

status 状态码

reason 描述

0

操作成功

106

被识别图片格式不对

1020

超过当天识别上限

1021

识别错误

1022

错误的账号(aiKey)类型

2 接口说明

2.1

请求方式:POST

Content-Type: application/json

请求地址:http://ai-api.easyar.com:8080/v1/pose/body

HTTPS: https://ai-api.easyar.com:8443/v1/pose/body

2.1.1 请求参数

属性

类型

约束

说明

image

String

必选

被识别的JPG图像用base64编码

输入是移动端摄像头采集的RGB图像(不要带alpha通道),对于人体姿态输入不建议采用横屏拍摄。

2.1.2 请求示例

POST /v1/pose/body HTTP/1.1
Host:
Date: Mon, 1 Jan 2018 00:00:00 GMT
Content-Type: application/json
{
    "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM..."
}

2.1.3 返回示例

成功的返回:

{
    "result": {
        "body": {
            "requestTime": "1536133241875",
            "class": {
                "twohandonhip": 0.9466071724891663,
                "liftup": 0.00028576390468515456,
                "handup": 0.00016984448302537203,
                "X": 0.004651500377804041,
                "jinBa": 0.04818731173872948,
                "L": 0.00009838885307544842,
                "others": 0.0077283382415771484
            }
        }
    },
    "statusCode": 0,
    "msg": "Success",
    "timestamp": 1536133243039
}

异常的返回:

{
        "result": "",
    "statusCode": 106,
    "msg": "Error: upload invalid RGB image",
    "timestamp": 1536132790001
}

返回说明:

statusCode:认证结果,0表示认证正确,1表示无效的应用秘钥,2表示无效的签名,3表示无效的日期

result:各个接口的返回结果在这里出现

timestamp:响应返回时的服务器端时间,用于在需要时调整需认证的请求中的时间

body: 该请求是识别的姿态(人体)

requestTime:客户端请求的时间

class: 这里的参数是识别结果,值最大的就是最有可能的结果

twohandonhip: 叉腰

liftup:平举

handup:平举

X:叉腰举高 X型

jinba:劲霸

L:L型

others:非以上人体姿态类型