腾讯云人脸识别活体人证比对使用说明

人证比对(支持活体)
 
简要描述
 
用户提供身份证号码,姓名及自拍照,服务对提供的信息进行检测,判断身份证号码,姓名是否对应有效,自拍照是否和身份证照片一致。

建议上传图片分辨率固定为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:无此身份证号

标签