API使用文档
更新时间:2023-11-29
简介
本文档主要说明如何使用价签识别API
获得使用权限
请提交合作咨询申请使用权限,提供公司名称和在EasyDL零售版控制台应用列表创建应用的APPID,如下图:
接口鉴权
- 进入EasyDL零售版的百度云控制台应用列表页面,如下图所示:
- 如果还未创建应用,请点击「创建应用」按钮进行创建。创建应用后,参考鉴权参考文档,使用API Key(AK)和Secret Key(SK)获取access_token
请求说明
请求示例
价签识别请求URL: https://aip.baidubce.com/rpc/2.0/easydl/v1/retail/price_tag
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格式 注意请去掉头部 |
提示:image参数中“去掉头部”指的是图片经base64编码后的头部信息「data:image/jpeg;base64,」,如下图所示:
返回说明
返回参数
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
log_id | 是 | number | 唯一的log id,用于问题定位 |
words_result_num | 否 | number | 检测到的价签数量 |
words_result | 否 | array(object) | 识别的价签信息 |
+name | 否 | string | 价签中的商品名称 |
+price | 否 | string | 价签中的价格 |
+brief | 否 | string | 价签中的其它文字信息 |
+location | 否 | 价签的像素位置 | |
++left | 否 | number | 检测到的目标主体区域到图片左边界的距离 |
++top | 否 | number | 检测到的目标主体区域到图片上边界的距离 |
++width | 否 | number | 检测到的目标主体区域的宽度 |
++height | 否 | number | 检测到的目标主体区域的高度 |