API调用方法
更新时间:2023-11-29
简介
本文档主要说明如何使用标准商品检测API,如有疑问可以通过以下方式联系我们:
- 在百度智能云控制台内提交工单,咨询问题类型请选择人工智能服务
接口列表
API名称 | 描述 | API |
---|---|---|
饮品检测 | 支持识别普通货架/货柜上陈列的饮品 | https://aip.baidubce.com/rpc/2.0/easydl/v1/retail/drink |
日化品检测 | 支持识别普通货架/货柜上陈列的日化用品 | https://aip.baidubce.com/rpc/2.0/easydl/v1/retail/daily_chemical |
饮品检测和日化品检测接口需要申请邀测,请加入QQ群(群号:1009661589)联系管理员,提供公司名称和在控制台创建应用的APPID
接口鉴权
- 进入EasyDL零售版的百度云控制台应用列表页面,如下图所示:
- 如果还未创建应用,请点击「创建应用」按钮进行创建。创建应用后,参考鉴权参考文档,使用API Key(AK)和Secret Key(SK)获取access_token
请求说明
请求示例
HTTP 方法:POST
URL参数:
参数 | 值 |
---|---|
access_token | 通过API Key和Secret Key获取的access_token,参考鉴权认证机制文档 |
Header如下:
参数 | 值 |
---|---|
Content-Type | application/json |
提示:如果出现336001或336002的错误码很可能是因为请求方式错误,请以json方式请求。
Body请求示例:
{
"image": "<base64数据>"
}
Body中放置请求参数,参数详情如下:
请求参数
参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
---|---|---|---|---|
image | 是 | string | - | 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式 注意请去掉头部 |
threshold | 否 | number | 0~1 | 可精确到小数点后两位,饮品检测API和日化品检测API threshold默认值为0.3。阈值(threshold),是正确结果的判定标准,例如:阈值是0.6,置信度(对应返回结果的score)大于0.6的识别结果会被当作正确结果返回。 |
提示:image参数中“去掉头部”指的是图片经base64编码后的头部信息「data:image/jpeg;base64,」,如下图所示:
返回说明
返回参数
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
log_id | 是 | number | 唯一的log id,用于问题定位 |
results | 否 | array(object) | 识别结果数组 |
+name | 否 | string | SKU名称_品牌名称_规格参数 |
+score | 否 | number | 置信度 |
+location | 否 | ||
++left | 否 | number | 检测到的目标主体区域到图片左边界的距离 |
++top | 否 | number | 检测到的目标主体区域到图片上边界的距离 |
++width | 否 | number | 检测到的目标主体区域的宽度 |
++height | 否 | number | 检测到的目标主体区域的高度 |