接口描述
请求路径:http://ai-tech.apigw-gz.didiyunapi.com/kouzhaodetect
请求方法:POST
输入参数
参数名称 | 必选 | 默认值 | 描述 |
---|---|---|---|
appname | 是 | com.didi.face-detection-mask.ddy | 认证时使用,Appname为默认即可 |
pid | 是 | 200152300 | 认证时使用,pid为默认即可 |
is_position | 否 | 0 | 是否返回人脸的位置坐标,1表示返回,0是不需要 |
image | 是 | 图片的base64编码 | 放在body里,key为image,value为图片的base64编码 |
输出参数
参数名称 | 类型 | 描述 |
---|---|---|
err_no | int | 识别状态,0表示成功,非0表示异常 详见状态码 |
err_msg | string | “success”表示成功,其它错误提示 |
logid | long | 方便排查后端错误原因 |
data | json | 请求返回的数据,详见数据注解 |
数据注解
参数名称 | 类型 | 描述 |
---|---|---|
candidate | 数组 | 包含多个人脸及口罩信息 |
driver | int | 是否为司机标识,1为是,0为否 |
mask | int | 是否有戴口罩,1为有人脸戴口罩,0为检测不到人脸,-1为有人脸没检测到口罩 |
location | json | 图片中人脸框的坐标,左上left、top,右下right、bot |
状态码
参数名称 | 描述 |
---|---|
0 | 检测成功 |
-6101 | 参数错误 |
-6102 | 内部错误 |
-6103 | 后端队列已满 |
-6104 | 其他错误 |
-6105 | 识别错误 |
-6106 | 载入图像错误 |
-6107 | 获取检测结果错误 |
-6108 | 识别引擎重置错误 |
示例
请求:
curl -X POST 'http://ai-tech.apigw-gz.didiyunapi.com/kouzhaodetect?appname=com.didi.face-detection-mask.ddy&pid=200152300' -H 'Authorization: AppCode ACDDo8xS5YNGtswRcNbsbVoaeg3MT1ET' -H 'Content-Type: application/json' -H 'Postman-Token: 9fa58c34-21ad-4e15-a131-3576750ed21e' -H 'cache-control: no-cache' -d '{"image":"imagebase64encode“}‘
输出:
{
"data": {
"candidate": [{
"driver": 0,
"location": {
"bot": 338.1216125488281,
"left": 146.8063964843750,
"right": 304.3013000488281,
"top": 126.1318588256836
},
"mask": 1
}, {
"driver": 1,
"location": {
"bot": 443.6951599121094,
"left": 903.3527221679688,
"right": 1126.237915039062,
"top": 128.5838928222656
},
"mask": 1
}, {
"driver": 0,
"location": {
"bot": 242.0659027099609,
"left": 645.1583862304688,
"right": 739.9298706054688,
"top": 136.1573028564453
},
"mask": 1
}, {
"driver": 0,
"location": {
"bot": 149.5413665771484,
"left": 445.2557983398438,
"right": 516.5772705078125,
"top": 65.47285461425781
},
"mask": -1
}]
},
"err_msg": "success",
"err_no": 0,
"logid": 2412492646
}