最近更新时间：2021-08-26
人脸检测定位用于快速检测图像中人脸数量，并返回所有人脸的位置坐标和关键点坐标信息。
调用地址：https://apim.unicloud.com/api/face/detection/1.0.0/
请求方式：POST
返回类型：JSON
Header如下：
| 参数 | 值 | 说明 |
|---|---|---|
| Content-Type | application/json | -- |
| Authorization | Bearer | 参考Token获取 |
Body如下：
| 参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
|---|---|---|---|---|
| img_file | true | file | -- | 含有人脸的图片（支持jpg、jpeg、png格式） |
注：Body使用form-data形式
curl -k -H "Authorization:Bearer 2b8296e1-86a5-3a68-bd61-9b88f9dce5c0" \ -F "img_file=@imgpath.jpg" https://apim.unicloud.com/api/face/detection/1.0.0/
curl -k -H "Authorization:Bearer 2b8296e1-86a5-3a68-bd61-9b88f9dce5c0" \ -F "img_file=@imgpath.jpg" \ https://apim.unicloud.com/api/face/detection/1.0.0/
curl -k -H "Authorization:Bearer 2b8296e1-86a5-3a68-bd61-9b88f9dce5c0" -F "img_file=@imgpath.jpg" https://apim.unicloud.com/api/face/detection/1.0.0/
| 字段 | 类型 | 说明 |
|---|---|---|
| data | object | 检测到的人脸数据 |
| +img_url | string | 处理后的图片在线地址 |
| +face_count | int | 检测到的人脸总数 |
| +face_data | list | 每一张人脸的坐标和五官坐标 |
| ++face_location | object | 人脸坐标 |
| ++landmark | list | 五官坐标 |
| code | int | 返回码（200：接口调用成功，400：文件格式错误或非法数据，500：程序异常退出） |
| message | string | 提示信息 |
{
"data":{
"img_url": "http://apim.unicloud.com/static/face_temp/20191023/12a3e2e38ca1f2e5153725672d8b22da.jpeg", ＃处理后的图片在线地址 "face_count":1, #检测到的人脸数
"face_data": [
{
"face_location":{ #人脸坐标
"x1":195,
"y1":106,
"x2":285,
"y2":196
},
"landmark":[ #人脸关键点的坐标数据，目前返回: 两个眼睛、一个鼻子、两个嘴角
[254,112],[272,111],[265,122],[257,131],[272,129]
]
}
]
},
"code":200,
"message":"success"
}{ "data":{ "img_url": "http://apim.unicloud.com/static/face_temp/20191023/12a3e2e38ca1f2e5153725672d8b22da.jpeg", ＃处理后的图片在线地址 "face_count":1, #检测到的人脸数
"face_data": [
{ "face_location":{ #人脸坐标
"x1":195, "y1":106, "x2":285, "y2":196
},
"landmark":[ #人脸关键点的坐标数据，目前返回: 两个眼睛、一个鼻子、两个嘴角
[254,112],[272,111],[265,122],[257,131],[272,129]
]
}
]
}, "code":200, "message":"success"}