人脸比对接口
2025.02.17 20:09:12
用户同时上传两张人脸照片,识别两张人脸的相似度,并判断是否为同一人
接口说明
使用建议:如果您的图片对比源是用户头像等高度美化PS过的照片,而采集源是真实人像(比如活体检测),建议您根据score字段自行判断比对结果。PS程度越高,阈值建议设置得越低。
鉴权说明
易盾信息认证服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权
请求
请求地址
名称 | 值 |
---|---|
HTTP URL | https://verify.dun.163.com/v1/facecompare/check |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"application/x-www-form-urlencoded" |
请求参数
请求参数由请求公共参数和请求业务参数两部分组成,通用参数见请求通用字段
名称 | 类 型 | 必填 | 最大长度 | 描述 |
---|---|---|---|---|
avatar1 | String | 是 | URL不超过256, BASE64不超过200K | 用于人脸比对的头像照,请上传无遮挡的清晰正面照,轮廓保持完整 |
avatar2 | String | 是 | URL不超过256, BASE64不超过200K | 用于人脸比对的头像照,请上传无遮挡的清晰正面照,轮廓保持完整 |
picType | Number | 是 | 4 | 图片类型:1-URL, 2-BASE64 |
dataId | String | 否 | 64 | 数据标识,可传入用户标识等数据,便于数据查询 |
请求体示例
avatar1=xxx&avatar2=xxx&picType=1&version=v1&businessId=xxx×tamp=1638180222235&nonce=xxx&secretId=xxx&signature=xxx
响应
响应结果
响应字段如下,响应通用字段已省略,详细见响应公共字段
名称 | 类型 | 必须返回 | 描述 |
---|---|---|---|
matched | Integer | 是 | 比对结果,1-是同一人 2-不是同一人 3-图片下载异常 |
score | Double | 是 | 相似度得分,范围0-1,分数越高,相似度越高。开发者也可根据自己的认证场景依据该字段控制自己的阈值 |
requestId | String | 是 | 本次请求数据标识,可以根据该标识在控制台进行数据查询 |
isPayed | Number | 是 | 本次请求是否收费标识,1代表收费,0代表不收费 |
响应体示例
{
"msg": "ok",
"result": {
"score": 0.7102633714675903,
"requestId": "b4c37ceb10304507b0954c27194c12ef",
"matched": 1,
"isPayed": 1
},
"code": 200
}
响应返回码
响应返回码见:响应返回码