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

功能描述

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

商品类目

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

前提条件

请确保您已经开通了商品理解服务。详情请参见服务开通

输入限制

  • 请求格式:JPG、JPEG、PNG、BMP。
  • 图像大小:图片大小不超过3M。
  • 图像分辨率:不限制图片分辨率,但图片分辨率太高可能会导致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

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

Categories Array

类目预测列表。

CategoryId String 584

类目ID。

CategoryName String 旁轴相机

类目名称。

Score Float 0.635774

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

RequestId String 67C34379-7732-40D7-B283-DB51C9434C9D

请求ID。

说明 您可以在 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 格式

<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 格式

{
	"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参考

单击SDK简介查看SDK信息。