智能多媒体服务 > API 文档 > 人脸核验 >功能接口 >人脸比对

人脸比对

最近更新时间: 2020-09-16 17:15:03

接口简介

七牛人脸对比接口face-compare 可将用户人脸照片和预留照片进行比对，判断是否为同一人。

注意

接口超时时间为 30 秒。
资源的 Mime 文件格式仅支持图片类型：image/*，如：image/jpeg、image/png。
请求接口为标准的HTTP/HTTPS 协议。
在核身场景下，一般前端SDK采集的刷脸照，会reszie到480x640，有些机型会是240x360。

请求语法

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

头部信息

头部名称	必填	说明
Host	是	固定为 face-compare.qiniuapi.com
Content-Type	是	固定为 application/json
Authorization	是	该参数应严格按照管理凭证格式进行填充，否则会返回 401 错误码。一个合法的 Authorization 值应类似于：Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7...

访问权限

请求 body

字段	是否必填	类型	说明
data_uri_a	是	string	图片数据 A: base64 编码或 http url
data_uri_b	是	string	图片数据 B: base64 编码或 http url
rotate_A	否	bool	人脸检测失败时，是否对图像 A 做旋转再检测，旋转角包括 90、180、270 三个角度，默认值为 False
rotate_B	否	bool	人脸检测失败时，是否对图像 B 做旋转再检测，旋转角包括 90、180、270 三个角度，默认值为 False
maxface_A	否	bool	图像 A 中检测到多张人脸时是否取最大区域的人脸作为输出，默认值为 True
maxface_B	否	bool	图像 B 中检测到多张人脸时是否取最大区域的人脸作为输出，默认值为 True

字段	类型	说明
session_id	string	唯一会话 id
similarity	float	两个 face 的相似度, 取值范围为[0,100]
errorcode	int	返回状态码
errormsg	string	返回错误消息

示例

POST face-compare.qiniuapi.com/facecompare HTTP/1.1
Host: face-compare.qiniuapi.com

Authorization: Qiniu aWQ6lF1Zxxse43jB6V7lsdfaadf:7cWZPxxxxxasdffed60zkI8=
Content-Type: application/json 
{
    “data_uri_a”: IMAGEA_DATA,
    “data_uri_b”: IMAGE_DATA,
    “rotate_A”: True,
    “rotate_B”: True 
}

返回示例

{"similarity": 24.813754610801773, "errorcode": 0, "errormsg": "OK", "session_id": "20200401083910JsougkqMNw"}

人脸对比错误码

错误码	错误信息	说明
0	OK	请求成功，无错误
55060001	ERROR_PARAMETER_INVALID	请求字段有非法传输
55060002	IMAGE_DECODE_FAILED	图片解码失败
55060028	IMAGEA_BASE64_DECODE_FAILED	人脸比对图片 A Base64 解码失败
55060029	IMAGEB_BASE64_DECODE_FAILED	人脸比对图片 B Base64 解码失败
55060040	IMAGEA_FACE_DETECT_FAILED	图片A人脸检测失败
55060041	IMAGEB_FACE_DETECT_FAILED	图片B人脸检测失败

以上内容是否对您有帮助？