取出酒瓶动作核验接口

一、接口描述

1. 功能描述

取出酒瓶动作核验接口的主要功能为:检验用户输入的图片是否为取出酒瓶的动作,并返回结果。

2. 能力说明:

取出酒瓶动作核验接口提供了取酒瓶动作识别的算法能力,能够判断图片中的内容是否包含取酒瓶动作。

3. 接口数据要求:

  1. 输入图片格式:Base64(原始图片格式为jpg,RGB三通道图像);
  2. 图像尺寸:输入图像的宽和高均不低于512,且均不大于2048。

4. 接口使用:

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

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

二、请求说明

1. 接口地址 :

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

2. 请求说明

(1) 请求方式:

post

(2) 请求参数

(a)query请求参数

公共请求参数

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

业务请求参数

名称 类型 必填 示例值 描述
Content-Type string application/json 标准json格式
(c)body请求参数

业务请求参数

名称 类型 必填 示例值 描述
img_base64 string 图像Base64编码值,去掉图片头"data:image/jpg;base64,",img_base64=iVBORw0K...(由于过长,不给出完整示例) 图像的Base64编码
request_id string "2c20715b-cfde-4048-96d3-fe831b5c80d1" 请求ID,前端请求时生成的用于标识此次请求的UUID

(3) 请求代码示例

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

三、返回说明

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参数信息

名称 类型 示例值 描述
status_code string 0 参照四、错误码-业务错误码
status_message string "success" 参照四、错误码-业务错误信息
check_result int 1 模型识别的结果。返回结果与含义对应关系如下表所示
description string "取酒瓶" 返回的check_result的描述
request_id string "2c20715b-cfde-4048-96d3-fe831b5c80d1" 用户在请求接口时传入的request_id,返回结果时再次回传给用户

check_result值及对应的含义: 返回值 | 含义 ------ | ------ 0 | 在输入图片中未检测到取出酒瓶的动作 1 | 在输入图片中检测到取出酒瓶的动作

2. 返回示例

{
    "code": "0",
    "charge": false,
    "remain": 0,
    "msg": "查询成功",
    "result":  {
        "status_code": "0",
        "status_message": "success",
        "check_result": 1,
        "description": "取酒瓶",
        "request_id": "2c20715b-cfde-4048-96d3-fe831b5c80d1"
   }
}

三、错误码

1.系统级错误码

详见返回码

2.业务错误码

业务错误码(status_code) 信息(status_message) 说明
0 "success" 成功
40000 "missing request id" 缺少参数:request_id
40001 "missing base64" 缺少参数:img_base64
40002 "unsupport request id" 不支持的request_id
40003 "broken base64" img_base64解析错误
40004 "image too large" 图像过大,图像长、宽均应小于2048
40005 "image too small" 图像过小,图像长、宽均应大于512
50000 "internal server error" 系统内部错误
Copyright © JD AI Platform all right reserved,powered by GitbookFile Modify: 2021-05-21 22:10:38

results matching ""

    No results matching ""