人脸比对接口

2024.04.18 10:26:19

    用户同时上传两张人脸照片,识别两张人脸的相似度,并判断是否为同一人

    接口说明

    使用建议:如果您的图片对比源是用户头像等高度美化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&timestamp=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
    }
    

    响应返回码

    响应返回码见:响应返回码

    在线咨询 电话咨询:95163223 免费试用