接口描述

请求路径：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"
}