智能多媒体服务

  • 智能多媒体 > API Reference > 人脸核验 >人脸比对

    人脸比对

    最近更新时间:2020-05-22 17:39:37

    接口简介

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

    注意

    • 接口超时时间为 30 秒。
    • 资源的 Mime 文件格式仅 application/json。
    • 请求接口为标准的HTTP/HTTPS 协议。

    请求语法

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

    注意: 要在Authorization 头部的AccessToken 前添加 QBox和半角空格。

    头部信息

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

    访问权限

    请求 body

    字段 是否必填 类型 说明
    imageA_b64 string base64编码的图片数据A
    imageB_b64 string base64编码的图片数据B
    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 
    {
        “imageA_b64”: IMAGEA_DATA,
        “imageB_b64”: IMAGE_DATA,
        “image_type_B”: 1, 
        “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 解码失败
    以上内容是否对您有帮助?
  • Icon free helper
    Close