腾讯云人脸识别活体人证比对使用说明
人证比对(支持活体)
简要描述
用户提供身份证号码,姓名及自拍照,服务对提供的信息进行检测,判断身份证号码,姓名是否对应有效,自拍照是否和身份证照片一致。
建议上传图片分辨率固定为480*640,不超过1080P。
建议上传照片是头像(人脸部分),避免人脸部分过小,照片清晰,表情自然,光线均匀,避免强光、逆光和阴阳脸出现。
照片要求正面、俯仰、平面角度均不大于15度,左右角度不大于30度,面部轮廓清晰,双眼距离建议不小于90像素,表情自然。
请求参数说明
注:Content-Type为'application/json; charset=utf-8'
{ "request_id":"abcdefg", // [string] 用户http请求的唯一标识,由客户端生成
"agreement_id":"AI", // [string] 用户协议唯一标识,由客户端传入系统英文简称
"person_id":"123456789012345678", // [string] 身份证号码
"person_name":"张三", // [string] 用户姓名
"bio":true, // [bool] 是否使用腾讯的活体检测功能(腾讯的活体检测更准确,true为使用、false为不使用)
"device":{
"plat":"3", // [string] 平台,其中客户端平台类型为(1->android, 2->ios, 3->pc, 4-> server)
"version":"10.3.3", // [string] 版本号
"model":"MBP 2017" // [string] 机型
},
"file":{
"type":"jpg", // [string] 文件类型
"data":"XXXX" // [string] Base64编码后的图片内容
}
}
返回参数说明
注:Content-Type'application/json; charset=utf-8'
注:当错误码code不为0时,data部分数据返回为空字符串
{ "code":0, // [string] 接口状态码
"msg":"", // [string] 结果描述
"request_id":"abcdefg", // [string] 请求的唯一标识
"data":{
"similarity":80.12, // [string] 自拍照和标准底照相似度
"ref_thres":"{"1e-3":76.5,"1e-4":90.6}" // [string] 参考阈值(1e-3为千分之一误识率对应的阈值、1e-4为万分之一误识率对应的阈值)
},
"cost_time":345 // [int] 接口处理时间( ms)
}
错误码说明
0
接口调用成功(返回相似度用于验证生活照和公安照是否为同一人,超过推荐阈值即判断为同一人)
402**
人脸检测不通过
40201:没有人脸
403**
照片质量不通过
40301:图片太大 40302:照片模糊 40303:质量不通过 40304:图片解析错误
404**
活体识别失败(活体相似度低于默认阈值,判断为非活体)
40401:非活体
405**
身份证底图问题
40501:底图不存在 40502:底图解析错误
401**
双因素(姓名或身份证)不通过
40101:认证未通过 40102:姓名格式不正确,不能为空 40103:身份证号码有误 40105:无此身份证号