人脸对比京东数科版


一、接口描述

1.功能描述

人脸比对接口服务,用于比对两张人脸图片的相似度,可用于判断是否为同一个人的可能性。

  • 支持照片类型:证件照、网纹照、生活照等。
  • 支持防伪类型:RGB、深度图、近红外图。
  • 常见应用场景:用户认证环节、人证合一认证。

2. 接口使用

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

在获得使用权限后,您可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程

3.图片要求

  1. Base64编码:请求中的图片需经过base64编码。请注意,图片base64编码是不包含图片头的,如data:image/jpg;base64等。
  2. 图片格式:现支持PNG、JPG、JPEG等格式,暂不支持GIF格式图片。
  3. 图片文件大小:小于1MB。
  4. 请求报文大小限制:body体不超过10MB,header头不超过8KB。

二、请求说明

1. 接口地址 :

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

2. 请求方式:

https post aiapi.jd.com/jdai/faceCompareJdd

3. 请求参数

(1)query请求参数

公共请求参数

名称 类型 必填 示例值 描述
appkey string 80d2b762ecb86593f9668526920f46c 您的appkey,可在买家中心控制台中获
timestamp long 1541491668060 请求的时间戳,精确到毫秒,timestamp有效期5分钟
sign string 2e148773a0337a8f2200ba90d445f083 签名,根据规则MD5(sectetkey+timestamp)

(2)body请求参数

业务请求参数

名称 类型 必填 示例值 描述
compareImageItem ImageItem {} 目标图片Base64编码,不做防伪检测。
collectionImageItems List< ImageItem> {} 采集照图片Base64编码,可配置启用防伪检测。支持三种类型: RGB:只需要传一张imgType为SFF类型的图片。 近红外:除需要传一张RGB图之外,还需要传一张NIR类型的图片。 深度:需要在传入3张图片。图片格式分别为:SFF、NIR、DEEP

ImageItem格式定义

参数名 含义 类型 是否必传 备注
imgType 图片类型 Enum Y SFF--"采集照"
NIR--"双目采集的近红外照片"
DEEP--"深度采集的照片"
IDP--"身份证正面"
IDN--"身份证反面"
MP--"网纹照"
AP--"动作照"
VL--"驾驶证"
BANKCARD--"银行卡"
imgBase64 Base64格式 String N 请不要包含 data:image/jpg;base64 等信息
imgUrl 图片地址 String N 从服务端可访问公网 http 地址。
filename 文件地址 String N 平台返回的文件名
encryptionType 图片加密算法 String N

Body示例

{
    "compareImageItem": {
        "imgBase64": "xxxxxxxxxx",
        "encryptionType": "NON",
        "imgType": "SFF"
    },
    "collectionImageItems": [
        {
            "imgBase64": "xxxxxxxxxx",
            "encryptionType": "NON",
            "imgType": "SFF"
        }
    ]
}

4、请求代码示例

建议您使用我们提供的SDK进行调用,SDK获取及调用方式详见本页一接口描述中的2接口使用

返回说明

1、返回参数

(1)公共返回参数

名称 类型 示例值 描述
code string 1000 参见下方错误码-系统级错误码
charge boolean false 或 true false:不扣费, true:扣费
remainTimes long 1305 剩余调用次数;免费api:每天剩余调用次数;收费api:剩余次数;无限制时为-1
remainSeconds long 1223456 剩余调用时间(s);免费api:-1;收费api:剩余调用时间;无限制时为-1
msg string 查询成功 参见下方错误码-系统级错误码数
result object {...} 查询结果

(2)业务返回参数

名称 类型 示例值 描述
code int 0 返回结果,0表示成功,非0为对应错误号
msg string 成功 错误信息
threshold Object {
"e4": 0.0,
"e5": 0.0,
"e6": 0.0
}
置信度阈值:
e4--误识率为万分之一的阈值;
e5--误识率为十万分之一的阈值;
e6--误识率为百万分之一的阈值;
score float 0.65 人脸相似度:
万分之一误识率下阈值: 0.49,
十万分之一误识率下阈值: 0.54,
百万分之一误识率下阈值:0.58
hacknessScore Object 0.14896475 攻击分值
similarity float 100 相似度分值
frrThreshold Object {
"e2": 0.0,
"e3": 0.0
}
e2-- 误拒率为百分之一的阈值
e3--误拒率为千分之一的阈值

2、返回示例

{
    "code": "10000",
    "charge": false,
    "remainTimes": 499,
    "remainSeconds": -1,
    "msg": "查询成功",
    "result": {
        "score": 0,
        "hacknessThreshold": {
        "e2": 0.8282,
        "e2_5": 0.3439,
        "e3": 0.9764
         },
        "similarity": 100,
        "threshold": {
           "e5": 1.092,
           "e6": 1.0403,
           "e7": 0.9829,
           "e4": 1.1477
        },
        "hacknessScore": 0.08075819
    }
}

四、错误码

1.系统级错误码

详见返回码

2.业务错误码

2.1 接入层错误码

返回码(code) 说明(message)
0 "成功"
500 "系统错误"
70400001 "参数不正确"
70400002 "请求head不正确, 请检查是否包含appId, sign, timestamp参数"
70400003 "签名不正确"
70400004 "请求路径不存在, 请仔细检查"
70400005 "应用不存在或已失效状态"
70401001 "应用未授权"
70401003 "用户无应用权限"
70401005 "你的应用没有调用此接口权限"
70401104 "签名已被使用"
70403001 "接口请求达到QPS配额限制"
70403002 "接口请求达到全天配额限制"
70403003 "请求报文过大"
70403009 "不允许的请求"
70500001 "调用失败"
70500002 "调用超时"
70500011 "核心服务不可用"
70500012 "不允许的操作"

2.2 业务错误码

返回码(code) 说明(message)
200000 "认证中"
100001 "姓名证件号校验不匹配"
100002 "解密数据失败"
100003 "查询结果为空"
100004 "设备不支持"
900001 "未知调用者"
900004 "参数错误"
900006 "认证失败"
900007 "重试次数超限"
1107 "用户未实名"
1108 "人脸出框"
1157 "图片存在攻击行为"
102 "人脸姿态非法!"
103 "人脸图片过小!"
1115 "未通过!"
Copyright © JD AI Platform all right reserved,powered by GitbookFile Modify: 2020-11-26 03:27:28

results matching ""

    No results matching ""