6.7 人脸检测：face_detection
图片要求
图片格式：PNG/JPG/JPEG
像素尺寸：最小像素8080，最大像素19201920
准确率：参考值（FDDB，95%），准确率会随着图像的尺寸/分辨率以及检测环境的不同会有所变化。
请求地址
http://api.robotscloud.com/osr/v1/face_detection
请求方法
Post方法。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| token | String | 是 | 通过调用token接口返回 |
| file | String | 是 | 需要检测的图片文件 |
返回参数
| 名称 | 类型 | 描述 |
|---|---|---|
| ret | Int | 0：正常返回；非0时为错误值； |
| msg | String | 描述 |
| facefeatures | Array | 人脸特征数组 |
facefeatures数组的元素定义：
| 名称 | 类型 | 描述 |
|---|---|---|
| face | Object | 人脸信息 |
face 对象的元素定义：
| 名称 | 类型 | 描述 |
|---|---|---|
| coordinate | Array | 人脸坐标：依次为左上角X、Y坐标、右下角X、Y坐标 |
| confidence | Float | 人脸置信度 |
错误码
| 错误代码 | 描述 | 语义 |
|---|---|---|
| 0 | 正确 | 无 |
| 非0 | 错误 | 详见 msg |
示例
请求示例
curl -X POST "http://api.robotscloud.com/osr/v1/face_detection" \
-F "token=qg9vRfvofK9b4xsWh1kHnEb998lQZYw" \
-F "file=@test.png"
返回示例
{
"ret": 0,
"msg": "ok",
"facefeatures": [
{
"face": {
"coordinate": [
472,
172,
532,
247
],
"confidence": 0.9987719655036926
}
},
{
"face": {
"coordinate": [
603,
208,
652,
270
],
"confidence": 0.996982991695404
}
},
{
"face": {
"coordinate": [
379,
220,
429,
284
],
"confidence": 0.9934282898902893
}
}
]
}