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