本文介绍商品分类ClassifyCommodity的语法及示例。

功能描述

商品分类可以识别图像中的商品分类,返回商品类目、置信度等信息。目前已经支持服饰鞋包、3C数码、家居用品等超过六千种类目分类。

商品类目

请单击枚举类目查看当前支持识别的商品类目。

前提条件

输入限制

  • 请求格式:JPG、JPEG、PNG、BMP。
  • 图像大小:不超过3 MB。
  • 图像分辨率:不限制图像分辨率,但图片分辨率太高可能会导致API识别超时,超时时间为5秒。
  • URL地址中不能包含中文字符。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ClassifyCommodity

系统规定参数。取值:ClassifyCommodity

ImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/tiankong/4%E5%95%86%E5%93%81%E5%88%86%E7%B1%BB.jpg

图像URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

返回数据

名称 类型 示例值 描述
RequestId String 67C34379-7732-40D7-B283-DB51C9434C9D

请求ID。

Data Object

返回的结果数据内容。

Categories Array of Category

类目预测列表。

Score Float 0.635774

分类ID的匹配度,大于0小于等于1。

CategoryId String 584

类目ID。

CategoryName String 旁轴相机

类目名称。

说明 您可以在 category.txt 文件中查看该接口支持的类目ID和类目名称。

示例

请求示例

http(s)://[Endpoint]/?Action=ClassifyCommodity
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/tiankong/4%E5%95%86%E5%93%81%E5%88%86%E7%B1%BB.jpg
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>67C34379-7732-40D7-B283-DB51C9434C9D</RequestId>
<Data>
    <Categories>
        <CategoryId>584</CategoryId>
        <Score>0.635774</Score>
        <CategoryName>旁轴相机</CategoryName>
    </Categories>
    <Categories>
        <CategoryId>4856</CategoryId>
        <Score>0.127052</Score>
        <CategoryName>数码单反</CategoryName>
    </Categories>
    <Categories>
        <CategoryId>733</CategoryId>
        <Score>0.0626836</Score>
        <CategoryName>单电微单</CategoryName>
    </Categories>
    <Categories>
        <CategoryId>5978</CategoryId>
        <Score>0.0565828</Score>
        <CategoryName>单反镜头</CategoryName>
    </Categories>
</Data>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "67C34379-7732-40D7-B283-DB51C9434C9D",
  "Data" : {
    "Categories" : [ {
      "CategoryId" : "584",
      "Score" : "0.635774",
      "CategoryName" : "旁轴相机"
    }, {
      "CategoryId" : "4856",
      "Score" : "0.127052",
      "CategoryName" : "数码单反"
    }, {
      "CategoryId" : "733",
      "Score" : "0.0626836",
      "CategoryName" : "单电微单"
    }, {
      "CategoryId" : "5978",
      "Score" : "0.0565828",
      "CategoryName" : "单反镜头"
    } ]
  }
}

错误码

关于商品分类的错误码,详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。