人脸检测与属性分析京东数科版


一、接口描述

1.功能描述

人脸检测接口服务,用于检测图像中的人脸,定位并返回人脸框位置、人脸五官与轮廓的关键点坐标,准确识别年龄、性别、情绪、颜值等多种人脸属性,对大角度侧脸、遮挡、表情变化、模糊等都有较好的适应性。

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/faceDetectdJdd

2. 请求方式:

https post aiapi.jd.com/jdai/faceDetectdJdd

3. 请求参数

(1)query请求参数

公共请求参数

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

(2)body请求参数

业务请求参数

名称 类型 必填 描述
imageItemList 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

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)业务返回参数

名称 类型 示例值 描述
result object {...} API调用结果
data object {...} 返回数据

API调用结果result结构

名称 类型 示例值 描述
code int 0 返回结果,0表示接口调用成功,非0为对应错误号
msg string 成功 错误信息
serialNo string 序列号
timestamp long 1554976436529 请求的时间戳,精确到毫秒,timestamp有效期5分钟

API调用结果data结构

名称 类型 示例值 描述
detectFaceNum int 1 人脸个数
detectedFaceItems List<object> Object格式如下 人脸检测信息
名称 类型 示例值 描述
boundingBox Object 人脸在图片中位置
--top Integer 人脸在图片中的纵向坐标
--left Integer 人脸在图片中的横向坐标
--width Integer 人脸在图片中的宽度
--height Integer 人脸在图片中的高度
landmark Object 68个关键点
--x Integer 关键点[].x
--y Integer 关键点[].y

2、返回示例

{
  "code": "10000",
  "charge": false,
  "remainTimes": 4998,
  "remainSeconds": -1,
  "msg": "查询成功",
  "result": {
    "data": {
      "detectFaceNum": 1,
      "detectedFaceItems": [
        {
          "boundingBox": {
            "width": 91,
            "top": 61,
            "left": 335,
            "height": 123
          },
          "attribute": {
            "expression": "NEUTRAL",
            "gender": "FEMALE",
            "age": 20
          },
          "landmark": [
            {
              "x": 332,
              "y": 101
            },
            {
              "x": 333,
              "y": 114
            },
            {
              "x": 334,
              "y": 126
            },
            {
              "x": 337,
              "y": 139
            },
            {
              "x": 340,
              "y": 151
            },
            {
              "x": 345,
              "y": 162
            },
            {
              "x": 352,
              "y": 171
            },
            {
              "x": 360,
              "y": 180
            },
            {
              "x": 369,
              "y": 183
            },
            {
              "x": 381,
              "y": 183
            },
            {
              "x": 393,
              "y": 178
            },
            {
              "x": 404,
              "y": 171
            },
            {
              "x": 412,
              "y": 162
            },
            {
              "x": 418,
              "y": 150
            },
            {
              "x": 422,
              "y": 138
            },
            {
              "x": 426,
              "y": 125
            },
            {
              "x": 429,
              "y": 112
            },
            {
              "x": 338,
              "y": 96
            },
            {
              "x": 344,
              "y": 92
            },
            {
              "x": 352,
              "y": 92
            },
            {
              "x": 359,
              "y": 95
            },
            {
              "x": 366,
              "y": 98
            },
            {
              "x": 382,
              "y": 99
            },
            {
              "x": 392,
              "y": 97
            },
            {
              "x": 401,
              "y": 97
            },
            {
              "x": 410,
              "y": 99
            },
            {
              "x": 418,
              "y": 105
            },
            {
              "x": 373,
              "y": 110
            },
            {
              "x": 372,
              "y": 119
            },
            {
              "x": 370,
              "y": 128
            },
            {
              "x": 369,
              "y": 137
            },
            {
              "x": 362,
              "y": 141
            },
            {
              "x": 366,
              "y": 143
            },
            {
              "x": 370,
              "y": 144
            },
            {
              "x": 374,
              "y": 143
            },
            {
              "x": 378,
              "y": 143
            },
            {
              "x": 344,
              "y": 106
            }
          ]
        }
      ]
    },
    "result": {
      "code": 0,
      "msg": "成功",
      "serialNo": "null",
      "timestamp": 1555055171118
    }
  }
}

四、错误码

1.系统级错误码

详见返回码

2.业务错误码

0 成功
500 系统错误
70400001 参数不正确
70400002 请求head不正确, 请检查是否包含appId, sign, timestamp参数
70400003 签名不正确
70400004 请求路径不存在, 请仔细检查
70400005 应用不存在或已失效状态
70401001 应用未授权
70401003 用户无应用权限
70401005 你的应用没有调用此接口权限
70401104 签名已被使用
70403001 接口请求达到QPS配额限制
70403002 接口请求达到全天配额限制
70403003 请求报文过大
70403009 不允许的请求
70500001 调用失败
70500002 调用超时
70500011 核心服务不可用
70500012 不允许的操作
Copyright © JD AI Platform all right reserved,powered by GitbookFile Modify: 2020-11-26 03:27:28

results matching ""

    No results matching ""