智能多媒体服务

  • 智能多媒体服务 > API 文档 > 1:1人脸比对

    1:1人脸比对

    最近更新时间: 2018-11-16 10:30:20

    接口简介


    七牛1:1人脸比对接口/face/sim可对用户输入的两张图片中检测到的最大人脸进行1:1比对,判断是否为同一人。结果返回两张图片中最大人脸框坐标、两张脸的相似度以及是否为同一人。返回的结果中还包含两张图片中人脸概率值的scorescore越高,表示检测结果的置信度越高。

    使用方式


    请求说明

    七牛1:1人脸比对接口支持对存储在七牛云 bucket(支持华东、华北和华南 bucket)或 非七牛云 bucket的图片进行智能识别。

    请求方式:POST
    请求url: http://ai.qiniuapi.com/v1/face/sim

    Header

    字段 取值
    Content-Type application/json
    Authorization Qiniu <AccessKey>:<Sign>
    注意: 用户请根据 AccessKey 和 SuccessKey 生成鉴权,以便进行身份验证。<Sign> 的取值请参考七牛鉴权

    请求字段说明

    字段 必选 取值 说明
    uri string 图片资源。支持两种资源表达方式:
    1. 网络图片URL地址;
    2. 图片 base64 编码字符串,需在编码字符串前加上前缀 data:application/octet-stream;base64, 例:data:application/octet-stream;base64,xxx

    请求示例

    POST /v1/face/sim  Http/1.1
    Content-Type:application/json
    Authorization:Qiniu <AccessKey>:<Sign>
    
    {
            "data": [{
                    "uri": "http://image2.jpeg"
            },{
                    "uri": "http://image1.jpeg"
            }]
    }
    
    


    返回说明

    字段 取值 说明
    code int 0:表示处理成功;不为0:表示出错
    message string 描述结果或出错信息
    faces list 两张图片中各选择出来进行对比的人脸信息
    score float 人脸检测的概率值,取值范围0~11为概率最高
    pts list 人脸在图片上的矩形框坐标
    similarity float 两张人脸相似度,取值范围0~1,1为概率最高
    same bool 判断是否为同一个人,true表示是同一个人,false表示不是同一个人。

    返回示例

    200 ok
    
    {
        "code": 0,
        "message": "success",
        "result": {
            "faces":[{
                      "score": 0.987,
                      "pts": [[225,195], [351,195], [351,389], [225,389]]
                      },
                      {
                      "score": 0.997,
                      "pts": [[225,195], [351,195], [351,389], [225,389]]
                      }], 
            "similarity": 0.87,
            "same": true
        }   
    }    
    

    文件适用规格


    可处理的图片文件:

    1. 图片大小不超过10M
    2. 图片尺寸不小于50x50,不超过4999x4999,图片过小则无法正确进行人脸识别。
    3. RGB通道数为3和3以内的图片,不能包含alpha通道
    4. 图片格式支持 png、jpg、jpeg、bmp、webp 和 gif

    服务价格


    总调用量P 费用
    单位:万张 单价(元/百张)
    0 < P ≤ 500 0.19
    500 < P ≤ 1500 0.18
    1500 < P ≤ 3000 0.15
    P > 3000 0.12

    计费示例

    某公司2018年5月使用1:1七牛云人脸比对别服务,共发起500万张人脸比对请求,
    则当月使用1:1七牛云人脸比对服务产生的费用为:

    确定的结果产生费用:0.19元/百张 * 500万张 = 9500 元

    总计费用:9500 元

    以上内容是否对您有帮助?
  • Qvm free helper
    Close