腾讯云-AI人脸检测API接入步骤和说明

一 接口描写

接口哀求域名：https://recognition.image.myqcloud.com/face/detect

本接口（detect）用于检测给定图片中的全部人脸( Face )的位置和响应的面下属性，位置包罗(x，y，w，h)，面下属性包罗性别( gender )、年数( age )、心情( expression )、魅力( beauty )、眼镜( glass )和姿态 (pitch，roll，yaw )。

留意：

本接口支持 HTTPS 协议，假如您此刻行使的是 HTTP 协议，为了保障您的数据安详，请切换至 HTTPS。

假如开拓者行使的是原域名（service.image.myqcloud.com）且已发生挪用，则无需改换域名。

二 哀求头 header

留意：

选择 multipart/form-data，请行使 HTTP 框架/库保举的方法配置哀求的 content-type，不保举直接挪用 setHeader 等要领配置，不然也许导致 boundary 缺失引起哀求失败。

三 输入参数

行使 application/json 名目，参数选择 url ；行使 multipart/form-data 名目，参数选择 image。

四 输出参数

FaceItem 声名：

留意：

假如图片中包括高出5张人脸，在返回的 FaceItem 中，只返回5张人脸完备信息，其他人脸只返回位置信息(face_id，x，y，width，height)，属性信息不返回。

五 示例

1.输入示例

行使 url 的哀求包

POST /face/detect HTTP/1.1
Authorization: FCHXdPTEwMDAwMzc5Jms9QUtJRGVRZDBrRU1yM2J4ZjhRckJi==
Host: recognition.image.myqcloud.com
Content-Length: 123
Content-Type: application/json

{
  "appid":"123456",
  "mode":1,
  "url":"http://test-123456.image.myqcloud.com/test.jpg"
}

行使 image 的哀求包

POST /face/detect HTTP/1.1
Authorization: FCHXdPTEwMDAwMzc5Jms9QUtJRGVRZDBrRU1yM2J4ZjhRckJi==
Host: recognition.image.myqcloud.com
Content-Length: 460
Content-Type: multipart/form-data;boundary=--------------acebdf13572468

----------------acebdf13572468
Content-Disposition: form-data; name="appid";

123456
----------------acebdf13572468
Content-Disposition: form-data; name="mode";

1
----------------acebdf13572468
Content-Disposition: form-data; name="image"; filename="test.jpg"
Content-Type: image/jpeg

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
----------------acebdf13572468--

2.输出示例

HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 313
Content-Type: application/json

{
  "data":{
    "session_id": "",
    "image_height": 200,
    "image_width": 200,
    "face": [{
      "face_id": "1005338790489817087",
      "x": 44,
      "y": 33,
      "height": 64.0,
      "width": 64.0,
      "pitch": 5,
      "roll": 0,
      "yaw": 6,
      "age": 37,
      "gender": 99,
      "glass": true,
      "expression": 6
      "beauty": 80
}]
  },
  "code":0,
  "message":"OK"
}

错误码

更多其他 API 错误码请查察错误码声名。

文章来历腾讯云，查察更多相干文档请会见https://cloud.tencent.com/document/product

（编辑：河北网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!