人脸比对
接口简介
七牛人脸对比接口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人脸检测失败 |
文档反馈
(如有产品使用问题,请提交工单)