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

2019年01月13日 由 荟荟 发表 577690 0

一  接口描述


接口请求域名: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
欢迎关注ATYUN官方公众号
商务合作及内容投稿请联系邮箱:bd@atyun.com
评论 登录
热门职位
Maluuba
20000~40000/月
Cisco
25000~30000/月 深圳市
PilotAILabs
30000~60000/年 深圳市
写评论取消
回复取消