所有文档

          EasyDL定制AI训练平台

          API调用方法

          接口描述

          本文档主要说明定制化商品检测模型发布后获得的API如何使用,如有疑问可以通过以下方式联系我们:

          • 在百度云控制台内提交工单,咨询问题类型请选择人工智能服务
          • 进入EasyDL社区交流,与其他开发者进行互动
          • 加入EasyDL官方QQ群(群号:1009661589)联系群管

          接口鉴权

          1. 进入EasyDL零售版的百度云控制台应用列表页面,如下图所示:

          1.png

          1. 如果还未创建应用,请点击「创建应用」按钮进行创建。创建应用后,参考鉴权参考文档,使用API Key(AK)和Secret Key(SK)获取access_token

          请求说明

          请求示例

          HTTP 方法:POST

          请求URL: 请首先在EasyDL零售版进行定制商品检测模型训练,完成训练后申请上线,上线成功后可在服务列表中查看并获取url。

          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 可精确到小数点后两位,默认值为建议阈值,请在 我的模型列表-完整评估结果 查看推荐阈值。阈值(threshold),是正确结果的判定标准,例如阈值是0.6,置信度大于0.6的识别结果会被当作正确结果返回。

          提示:image参数中“去掉头部”指的是图片经base64编码后的头部信息「data:image/jpeg;base64,」,如下图所示:

          返回说明

          注:开启模型服务功能可参考服务功能文档

          返回参数

          字段 是否必选 类型 说明 需要开启的模型服务功能
          statistics array(object) 图片上的综合识别统计结果 商品排面占比统计
          +known_sku_num number 定制商品检测模型识别的SKU总数量 商品排面占比统计
          +unknown_sku_num number 定制商品检测模型未识别的SKU总数量 商品排面占比统计
          +vacancy_num number 货架上的空位数量,如果图片为非货架陈列场景(如冰柜、端架、普通货架等),结果不具参考意义 商品排面占比统计
          +share_of_shelf float 定制商品检测模型识别SKU的排面占比 商品排面占比统计
          +utilization float 货架利用率,如果图片为非货架陈列场景(如冰柜、端架、普通货架等),结果不具参考意义 商品排面占比统计
          sku_count array(object) 定制商品检测模型识别的各类SKU的总数和排面占比 商品排面占比统计
          +name string 定制商品检测模型识别的SKU标签,SKU名称品牌名称规格参数,为在EasyDL零售版上创建SKU时填写的内容 商品排面占比统计
          +sku_code string 定制商品检测模型识别的SKU编码,为在EasyDL零售版上创建SKU时填写的内容 商品排面占比统计
          +sku_num number 定制商品检测模型识别的各类SKU的总数 商品排面占比统计
          +proportion float 定制商品检测模型识别的各类SKU的排面占比 商品排面占比统计
          layer_count array(object) 图片中,各货架的总层数 商品陈列层数识别
          +shelf number 商品所在货架编号,”-1“表示未识别到货架,编号为图中最左从往右数依次增大 商品陈列层数识别
          +layer_num number 货架的总层数,如果图片为非货架陈列场景(如冰柜、端架、普通货架等),结果不具参考意义 商品陈列层数识别
          layer_top number 判断是否拍摄到货架最上一层,0表示未拍摄到,1表示拍摄到,-1表示图片中未识别到货架 商品陈列层数识别
          scenes array(string) 图片中包含的陈列场景类型。返回所有场景去重后的集合,“GE”表示端架,“shelf”表示货架,“freezer”表示冰柜,“TG”表示地堆,“cutbox”表示割箱,"unknown"表示未识别到场景 商品陈列场景识别
          log_id number 唯一的log id,用于问题定位 商品基本信息识别(默认开启,必选)
          results array(object) 识别结果数组 -
          +name string SKU名称_品牌名称_规格参数 商品基本信息识别(必选)
          +scene string 图片中包含的陈列场景类型。返回所有场景去重后的集合,“GE”表示端架,“shelf”表示货架,“freezer”表示冰柜,“TG”表示地堆,“cutbox”表示割箱,"unknown"表示未识别到场景 商品陈列场景识别
          +shelf number 商品所在货架编号,”-1“表示未识别到货架,编号为图中最左从往右数依次增大 商品陈列层数识别
          +layer number 商品所在层数编号,”-1“表示未识别到层数,编号为从图中货架最上层往下依次增大 商品陈列层数识别
          +sku_code string 商品编号 商品基本信息识别(默认开启,必选)
          +score number 置信度 商品基本信息识别(默认开启,必选)
          +location 商品基本信息识别(默认开启,必选)
          ++left number 检测到的目标主体区域到图片左边界的距离 商品基本信息识别(默认开启,必选)
          ++top number 检测到的目标主体区域到图片上边界的距离 商品基本信息识别(默认开启,必选)
          ++width number 检测到的目标主体区域的宽度 商品基本信息识别(默认开启,必选)
          ++height number 检测到的目标主体区域的高度 商品基本信息识别(默认开启,必选)
          上一篇
          模型使用
          下一篇
          错误码