接口简介

七牛人脸对比接口face-detect，检测单张图片中的人脸信息。

注意

• 接口超时时间为 30 秒。
• 资源的 Mime 文件格式仅支持图片类型：image/*，如：image/jpeg、image/png。
• 请求接口为标准的HTTP/HTTPS 协议。
• 前端SDK采集的刷脸照，会reszie到480×640，有些机型会是240×360；证件照则一般在178×220 ~ 480×640之间。Resize之后，可以有效控制模型输入源，确保模型有比较好的性能。
• 如果客户没有使用SDK，而是直接调用人脸检测API，则建议按照上述规则对图片做预处理。

请求语法

POST http(s)://face-detect.qiniuapi.com/facedetect
Host: face-detect.qiniuapi.com
Content-Type: application/json
Authorization: QiniuToken

头部信息

请求 body

字段 | 是否必填 | 类型 |说明
:------------- | :— | :------------------------------------------
image_b64 | 是 | string | base64编码的图片数据
rotate | 否 | bool | 人脸检测失败时，是否对图像 A 做旋转再检测，旋转角包 括 90、180、270 三个角度，默认值为 False

返回

faceItem

示例

POST face-detect.qiniuapi.com/facedetect
HTTP/1.1
Host:face-detect.qiniuapi.com

Authorization: Qiniu aWQ6lF1Zxxse43jB6V7lsdfaadf:7cWZPxxxxxasdffed60zkI8=
Content-Type: application/json 
{
	“image_b64”: IMAGEA_DATA,
	“rotate”: True
}

同步请求

接口规格

注意：接口规格不含任何空格与换行符。

请求接口

GET <mediaDownloadURI>?face-detect

字段说明

返回示例

{
“num_face”: 1, “rotangle”: 0, “errorcode”: 0, “errormsg”: ‘OK”, “face”: [{“score”: 0.99, 
“x”: 10,
“y”: 20,
“width”: 96,
“height”: 96,
“blur”: 0.7,
“gender”: “M”,
“age”: 30, 
"illumination”: 70,
“facesize”: 70,
“quality”: 70,
“pitch”: 10,
“yaw”: 0,
“raw”: 5,
“completeness”: 1,
“area”:9216,
“face_aligned_b64”: ALIGNED_IMAGE_DATA,
"face_shape":{
"face_profile": [{"x":1,"y":1"}, {"x":2,"y":2}, ...], 
....,
"pupil": [{"x":555,"y":555"}, {"x":800,"y":800}
]
}

错误码