人脸对比新版

一、接口描述

1. 功能描述

基于人的脸部特征信息，计算两张脸的相似程度，并返回相似度评分，判断两者是否为同一个人

2. 接口数据要求：

1. 图片格式:base64编码
2. 图片类型: jpg/jpeg/png
3. 图片大小: 小于5M

3. 接口使用：

平台为每个API提供试用体验服务，您在AI市场选择“免费试用”规格下单后，即可开始体验业内领先的人工智能API服务。 免费试用服务具有调用量、QPS限制，如需更高性能的API服务，可以提交咨询工单，联系京东AI扩容购买。

在获得使用权限后，您可使用已经封装好的SDK/参照接口鉴权规则进行相应开发，整体流程详见 接入流程
用户需要使用营业执照图片base64编码去做请求，使用其他图片的base64编码请求成功时也会加入计费。

二、请求说明

1. 接口地址 ：

https://aiapi.jd.com/jdai/faceCompareNew

2. 请求方式：

 post

3. 请求参数

（1）query请求参数

公共请求参数

（2）header请求参数

业务请求参数

（3）body请求参数

业务请求参数

ImageItem说明，imgBase64、imgArr、imgUrl三选一

（4）请求代码示例

建议您使用我们提供的SDK进行调用

三、返回说明

1.返回参数

（1）公共返回参数

（2）业务返回参数

result参数信息

ConfidenceThreshold字段说明

2.返回示例

{
    "code": "10000",
    "charge": false,
    "remainTimes": 4998,
    "remainSeconds": -1,
    "msg": "查询成功",
    "result": {
        "result": false,
        "msg": "比对失败 :人脸比对判断 分数:0.7060586 阈值:0.8179 结果:false",
        "score": 0.7060586214065552,
        "code": 1155,
        "imgMap": {
            "SFF": {
                "valid": false,
                "filename": "COLLECTION_xxxxxxx"
            },
            "IDP": {
                "valid": false,
                "filename": "COLLECTION_xxxxxxxx"
            }
        },
        "similarity": 57,
        "threshold": {
            "e5": 1.0920000076293945,
            "e6": 1.0403000116348267,
            "e7": 0.9829000234603882,
            "e4": 1.1476999521255493
        },
        "hacknessVo": {},
        "serialNo": "1621270610624-010221159145-1821391",
        "timestamp": 1627977407152
    }
}

四、错误码信息

1.系统级错误码

详见返回码

2.业务错误码