1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
<?php return [
'version' => '1.0',
'info' => [
'style' => 'RPC',
'product' => 'goodstech',
'version' => '2019-12-30',
],
'directories' => [
'ClassifyCommodity',
],
'components' => [
'schemas' => [],
],
'apis' => [
'ClassifyCommodity' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [],
'parameters' => [
[
'name' => 'ImageURL',
'in' => 'query',
'schema' => [
'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。',
'type' => 'string',
'required' => true,
'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/goodstech/ClassifyCommodity/ClassifyCommodity1.jpg',
'isFileTransferUrl' => true,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '1',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '87C5AF93-F641-54C2-873D-0501E637489C',
],
'Data' => [
'description' => '返回的结果数据内容。',
'type' => 'object',
'properties' => [
'Categories' => [
'description' => '类目预测列表。',
'type' => 'array',
'items' => [
'description' => '1',
'type' => 'object',
'properties' => [
'Score' => [
'description' => '分类ID的匹配度，大于0小于等于1。',
'type' => 'number',
'format' => 'float',
'example' => '0.417248',
],
'CategoryId' => [
'description' => '类目ID。'."\n"
.'> 您可以在 [category.txt](https://viapi-demo.oss-cn-shanghai.aliyuncs.com/doc/category.txt?spm=a2c4g.11186623.2.16.2c1d687bEDtrmY&file=category.txt) 文件中查看该接口支持的类目ID和类目名称。',
'type' => 'string',
'example' => '584',
],
'CategoryName' => [
'description' => '类目名称。'."\n"
.'> 您可以在 [category.txt](https://viapi-demo.oss-cn-shanghai.aliyuncs.com/doc/category.txt?spm=a2c4g.11186623.2.16.2c1d687bEDtrmY&file=category.txt) 文件中查看该接口支持的类目ID和类目名称。',
'type' => 'string',
'example' => '旁轴相机',
],
],
],
],
],
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"87C5AF93-F641-54C2-873D-0501E637489C\\",\\n \\"Data\\": {\\n \\"Categories\\": [\\n {\\n \\"Score\\": 0.417248,\\n \\"CategoryId\\": \\"584\\",\\n \\"CategoryName\\": \\"旁轴相机\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<ClassifyCommodityResponse>\\n <RequestId>87C5AF93-F641-54C2-873D-0501E637489C</RequestId>\\n <Data>\\n <Categories>\\n <CategoryId>584</CategoryId>\\n <Score>0.417248</Score>\\n <CategoryName>旁轴相机</CategoryName>\\n </Categories>\\n <Categories>\\n <CategoryId>4856</CategoryId>\\n <Score>0.309264</Score>\\n <CategoryName>数码单反</CategoryName>\\n </Categories>\\n <Categories>\\n <CategoryId>733</CategoryId>\\n <Score>0.103179</Score>\\n <CategoryName>单电微单</CategoryName>\\n </Categories>\\n <Categories>\\n <CategoryId>5978</CategoryId>\\n <Score>0.0654835</Score>\\n <CategoryName>单反镜头</CategoryName>\\n </Categories>\\n </Data>\\n</ClassifyCommodityResponse>","errorExample":""}]',
'title' => '商品分类',
'summary' => '本文介绍商品分类ClassifyCommodity的语法及示例。',
'description' => '## 功能描述'."\n"
.'商品分类能力可以识别图像中的商品分类，返回商品类目、置信度等信息。目前已经支持服饰鞋包、3C数码、家居用品等超过六千种类目分类。'."\n"
."\n"
.'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n"
.'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=goodstech&children=ClassifyCommodity)对该能力进行更直观试用以及在线购买。'."\n"
.'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n"
."\n"
.'## 商品类目'."\n"
.'请单击[枚举类目](https://viapi-demo.oss-cn-shanghai.aliyuncs.com/doc/category.txt?spm=a2c4g.11186623.2.16.2c1d687bEDtrmY&file=category.txt)查看当前支持识别的商品类目。'."\n"
."\n"
.'## 接入指引'."\n"
.'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n"
.'2. 开通能力：'."\n"
.'- 请确保您已经开通了[商品理解服务](https://vision.aliyun.com/goodstech)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_goodstech_public_cn#/open)。'."\n"
.'- 开通服务后请[提交申请](https://vision.console.aliyun.com/cn-shanghai/applyopen/goodstech/ClassifyCommodity)，申请通过后方可使用。'."\n"
."\n"
.'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n"
.'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/goodstech/2019-12-30/ClassifyCommodity?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fgoodstech%2FClassifyCommodity%2FClassifyCommodity1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n"
.'5. 开发接入步骤：'."\n"
.'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n"
.'- 在对应语言的SDK文档中找到AI类目为商品理解（goodstech）的SDK包进行安装。'."\n"
.'- 参考文档中提供的示例代码进行适当修改后调用。'."\n"
."\n"
.'6. 示例代码：该能力常用语言的示例代码，请参见[商品分类示例代码](~~601099~~)。'."\n"
."\n"
.'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n"
.'- [Web前端直接调用](~~467779~~)'."\n"
.'- [小程序场景下直接调用](~~467780~~)'."\n"
.'- [Android端直接调用](~~467781~~)'."\n"
.'- [iOS端直接调用](~~467782~~)'."\n"
."\n"
.'## 输入限制'."\n"
.'- 图像格式：JPG、JPEG、PNG、BMP。'."\n"
.'- 图像大小：不超过3 MB。'."\n"
.'- 图像分辨率：不限制图像分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。'."\n"
.'- URL地址中不能包含中文字符。'."\n"
."\n"
.'## 计费说明'."\n"
.'关于商品分类的计费方式及报价，请参见[计费介绍](~~202477~~)。'."\n"
."\n"
.'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=goodstech&children=ClassifyCommodity)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => '## SDK参考'."\n"
.'阿里云视觉AI商品理解类目下的商品分类能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为商品理解（goodstech）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n"
."\n"
.'## 示例代码'."\n"
.'该能力常用语言的示例代码，请参见[商品分类示例代码](~~601099~~)。',
'extraInfo' => '## 错误码'."\n"
.'关于商品分类的错误码，详情请参见[常见错误码](~~146738~~)。'."\n"
."\n"
.'## 安全声明'."\n"
.'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n"
.'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。',
],
],
'endpoints' => [
[
'regionId' => 'cn-shanghai',
'endpoint' => 'goodstech.cn-shanghai.aliyuncs.com',
],
],
];
|
