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

1:1人脸比对

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

接口简介

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

使用方式

请求说明

七牛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~1`，`1`为概率最高
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
    }   
}

文件适用规格

可处理的图片文件：

图片大小不超过10M
图片尺寸不小于50x50，不超过4999x4999，图片过小则无法正确进行人脸识别。
RGB通道数为3和3以内的图片，不能包含alpha通道
图片格式支持 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 元

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