human: 如何处理七牛云的智能多媒体服务人脸比对

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 人脸核验 >功能接口 >人脸比对

#  人脸比对

最近更新时间: 2023-04-28 14:43:03

# 接口简介

七牛人脸对比接口`face-compare` 可将比对两张图片中人脸的相似度，并返回相似度分值。

# 请求

## 请求地址

名称 | 值  
---|---  
HTTP URL | `https://face-compare.qiniuapi.com/v2/facecompare`  
HTTP Method | POST  
  
## 请求头

名称 | 必填 | 说明  
---|---|---  
Host | 是 | 固定值 face-compare.qiniuapi.com  
Authorization | 是 | 该参数应严格按照[管理凭证格式 __](https://developer.qiniu.io/kodo/1201/access-token)进行填充，否则会返回 401 错误码。一个合法的 Authorization 值应类似于：Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7…  
Content-Type | 是 | 固定值application/json  
  
## 请求参数

字段 | 必填 | 类型 | 说明  
---|---|---|---  
image | 否 | string | 图片信息(总数据大小应小于10M，图片尺寸在1920x1080以下)  
image_type | 否 | string | 图片类型**BASE64** :图片的base64值，base64编码后的图片数据，编码后的图片大小不超过2M**URL** :图片的 URL地址( 可能由于网络等原因导致下载图片时间过长)  
face_type | 否 | string | 人脸的类型**LIVE** ：表示生活照：通常为手机、相机拍摄的人像图片、或从网络获取的人像图片等，**IDCARD** ：表示身份证芯片照：二代身份证内置芯片中的人像照片，**WATERMARK** ：表示带水印证件照：一般为带水印的小图，如公安网小图**CERT** ：表示证件照片：如拍摄的身份证、工卡、护照、学生证等证件图片**INFRARED** ：表示红外照片,使用红外相机拍摄的照片**HYBRID** ：表示混合类型，如果传递此值时会先对图片进行检测判断所属类型(生活照 or 证件照)（仅针对请求参数 image_type 为 BASE64 或 URL 时有效）默认`LIVE`  
quality_control | 否 | string | 图片质量控制**NONE** : 不进行控制**LOW** :较低的质量要求**NORMAL** : 一般的质量要求**HIGH** : 较高的质量要求默认 `NONE`若图片质量不满足要求，则返回结果中会提示质量检测失败  
liveness_control | 否 | string | 活体检测控制**NONE** : 不进行控制**LOW** :较低的活体要求(高通过率 低攻击拒绝率)**NORMAL** : 一般的活体要求(平衡的攻击拒绝率, 通过率)**HIGH** : 较高的活体要求(高攻击拒绝率 低通过率)默认 `NONE`若活体检测结果不满足要求，则返回结果中会提示活体检测失败  
face_sort_type | 否 | number | 人脸检测排序类型**0** :代表检测出的人脸按照人脸面积从大到小排列**1** :代表检测出的人脸按照距离图片中心从近到远排列默认为`0`  
spoofing_control | 否 | string | 合成图控制参数**NONE** : 不进行控制**LOW** :较低的合成图阈值数值，由于合成图判定逻辑为大于阈值视为合成图攻击，该项代表低通过率、高攻击拒绝率**NORMAL** : 一般的合成图阈值数值，由于合成图判定逻辑为大于阈值视为合成图攻击，该项代表平衡的攻击拒绝率, 通过率**HIGH** : 较高的合成图阈值数值，由于合成图判定逻辑为大于阈值视为合成图攻击，该项代表高通过率、低攻击拒绝率默认为`NONE`  
  
## 请求示例

    
    
    POST /v2/facecompare
    Host: face-compare.qiniuapi.com 
    Authorization: Qiniu token
    Content-Type: application/json
    
    [
        {
            "image": "sfasq35sadvsvqwr5q...",
            "image_type": "BASE64",
            "face_type": "LIVE",
            "quality_control": "LOW",
            "liveness_control": "HIGH"
        },
        {
            "image": "sfasq35sadvsvqwr5q...",
            "image_type": "BASE64",
            "face_type": "LIVE",
            "quality_control": "LOW",
            "liveness_control": "HIGH"
        }
    ]
    

# 响应

## 响应头

名称 | 必填 | 说明  
---|---|---  
Content-Type | 是 | 固定值application/json  
  
## 响应参数

字段 | 必填 | 类型 | 说明  
---|---|---|---  
error_code | 否 | number | 错误码  
error_msg | 否 | string | 错误信息  
log_id | 否 | number | 请求ID  
result | 否 | Object compare_result | 请求结果  
  
其中， _compare_result_ 参数

字段 | 必填 | 类型 | 说明  
---|---|---|---  
score | 否 | number | 人脸相似度得分，推荐阈值80分  
face_list | 否 | []object | 人脸信息列表  
  
其中，** 参数

字段 | 必填 | 类型 | 说明  
---|---|---|---  
face_token | 否 | string | 人脸的唯一标志  
  
## 响应示例

    
    
    200 
    Content-Type: application/json
    
    {
        "error_code": 0,
        "error_msg": "SUCCESS",
        "log_id": 2297991422,
        "result": {
            "score": 44.3,
            "face_list": [
                {
                    "face_token": "fid1"
                },
                {
                    "face_token": "fid2"
                }
            ]
        }
    }
    

​

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