接口描述
请求路径:https://aiapi-face.apigw-gz.didiyunapi.com/algo/face/v1/face_compare
请求方法:POST
输入参数
参数名称 | 必选 | 默认值 | 描述 |
---|---|---|---|
bizcode | 是 | 无 | 接入业务code。 |
uid | 是 | 无 | 请求的一个标识id。 |
name | 是 | 无 | 识别的人姓名,可为空。 |
card_id | 是 | 无 | 识别的人身份证号码,可为空。 |
face_type | 是 | 无 | 0:只选取图片中概率最大的人脸,1:选取图片中所有人脸,返回最相似的两个人脸的相似值,推荐为0。 |
image_url1 | 是 | 无 | 比对的底图url。 |
image_url2 | 是 | 无 | 比对的图片url。 |
输出参数
参数名称 | 类型 | 描述 |
---|---|---|
error_code | int | 识别状态code,0表示成功,非0表示异常 |
error_message | string | 识别状态code非0时对应的异常信息 |
time_used | int | 请求处理时间,单位ms |
request_id | string | 服务端标识请求的id |
uid | string | 客户端参数中的uid |
result | int | 1一致;0不一致;-1 虚假人脸 |
result_ref1 | Result_ref1 | 比对结果,包含相似度和参考阈值 |
face_genuineness | Face_genuineness | 被验证的人脸的真实性 |
Result_ref1:
参数名称 | 类型 | 描述 |
---|---|---|
confidence | double | 人脸相似度分数 |
thresholds | json | 相似度参考阈值:{"1e-3": 55.0, "1e-2": 47.95, "1e-5": 91.2, "1e-4": 63.6} |
Face_genuineness:
参数名称 | 类型 | 描述 |
---|---|---|
screen_replay_confidence | double | 被验证人脸虚假分数 |
screen_replay_threshold | double | 被验证人脸虚假分数参考阈值 |
错误码
示例
请求:
curl -H 'Content-Type: application/x-www-form-urlencoded' -H 'Authorization: AppCode ACDDQRLL2jOqxXygVqxOgLM8FF3flk8i' -X POST "http://aiapi-face.apigw-gz.didiyunapi.com/algo/face/v1/face_compare?uid='123'&name='xxx'&card_id='123'&face_type=0&image_url1='http://100.69.238.155:8002/static/labelpbi/imglabel/image_label/face_plate/face1.jpg'&image_url2='http://100.69.238.155:8002/static/labelpbi/imglabel/image_label/face_plate/face1.jpg'&bizcode=0"
输出:
{
"result_ref1":{
"confidence":100,
"thresholds":{
"1e-3":55,
"1e-2":47.95,
"1e-5":91.2,
"1e-4":63.6
}
},
"face_genuineness":{
"screen_replay_confidence":0.874,
"screen_replay_threshold":0.5
},
"uid":"123",
"time_used":117,
"result":-1,
"request_id":"d86bab92-f5c0-460e-8f22-11ae34282499"
}