1. API说明

人脸检测接口用以检测给定图片是否存在人脸,并返回人脸的位置。

调用方式:POST

调用地址:/v1/eval/facex-detect

返回类型:JSON

2. 示例代码

请求示例:

POST /v1/eval/facex-detect  Http/1.1
Content-Type: application/json
Authorization: Qiniu <AccessKey>:<Sign>

{
  "data": {
    "uri": "https://dn-ors35x6a7.qbox.me/atshow-face-detection-20170703/1.png?imageslim"
  }
}

返回示例:

200 ok

{
  "code": 0,
  "message": "",
  "result": {
    "detections": [
      {
        "index": 1,
        "class": "face",
        "score": 0.9997,
        "pts": [
          [
            163,
            50
          ],
          [
            263,
            50
          ],
          [
            263,
            191
          ],
          [
            163,
            191
          ]
        ]
      }
    ]
  }
}

请求字段说明:

字段 取值 说明
uri string 图片资源地址

返回字段说明:

字段 取值 说明
code int 0:表示处理成功;不为0:表示出错
message string 描述结果或出错信息
index {1} index值始终为1
class {"face"} class值始终为face
score float 人脸框的准确度,取值范围0~1,1为准确度最高
pts 四点坐标值 [左上,右上,右下,左下]四点坐标框定的脸部