智能多媒体服务

  • 智能多媒体 > 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人脸检测失败
    以上内容是否对您有帮助?
  • Qvm free helper
    Close