商品分類
本文介紹商品理解(goodstech)類目下的商品分類ClassifyCommodity的語法及示例。
功能描述
商品分類能力可以識(shí)別圖像中的商品分類,返回商品類目、置信度等信息。目前已經(jīng)支持服飾鞋包、3C數(shù)碼、家居用品等超過六千種類目分類。
商品類目
請(qǐng)單擊枚舉類目查看當(dāng)前支持識(shí)別的商品類目。
接入指引
1. 注冊(cè)阿里云賬號(hào):打開阿里云官網(wǎng),在阿里云官網(wǎng)右上角,單擊立即注冊(cè),按照操作提示完成賬號(hào)注冊(cè)。
2. 開通能力:
- 請(qǐng)確保您已經(jīng)開通了商品理解服務(wù),若未開通服務(wù)請(qǐng)立即開通。
- 開通服務(wù)后請(qǐng)提交申請(qǐng),申請(qǐng)通過后方可使用。
3. 創(chuàng)建AccessKey:請(qǐng)確保您已創(chuàng)建AccessKey,如果您使用的是子賬號(hào)AccessKey,您需要給子賬號(hào)賦予AliyunVIAPIFullAccess權(quán)限,具體操作,請(qǐng)參見RAM授權(quán)。
4. 在線調(diào)試(可選):您可以通過OpenAPI Explorer在線調(diào)試能力,查看完整的調(diào)用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發(fā)接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對(duì)應(yīng)語言的SDK文檔中找到AI類目為商品理解(goodstech)的SDK包進(jìn)行安裝。
- 參考文檔中提供的示例代碼進(jìn)行適當(dāng)修改后調(diào)用。
6. 示例代碼:該能力常用語言的示例代碼,請(qǐng)參見商品分類示例代碼。
7. 客戶端直接調(diào)用:該能力常用的客戶端調(diào)用方式包括以下幾種。
輸入限制
- 圖像格式:JPG、JPEG、PNG、BMP。
- 圖像大小:不超過3 MB。
- 圖像分辨率:不限制圖像分辨率,但圖片分辨率太高可能會(huì)導(dǎo)致API識(shí)別超時(shí),超時(shí)時(shí)間為5秒。
- URL地址中不能包含中文字符。
計(jì)費(fèi)說明
關(guān)于商品分類的計(jì)費(fèi)方式及報(bào)價(jià),請(qǐng)參見計(jì)費(fèi)介紹。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | ClassifyCommodity | 系統(tǒng)規(guī)定參數(shù)。取值:ClassifyCommodity。 |
ImageURL | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/goodstech/ClassifyCommodity/ClassifyCommodity1.jpg | 圖像URL地址。推薦使用上海地域的OSS鏈接,對(duì)于文件在本地或者非上海地域OSS鏈接的情況,請(qǐng)參見文件URL處理。 |
返回?cái)?shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 87C5AF93-F641-54C2-873D-0501E637489C | 請(qǐng)求ID。 |
Data | Object | 返回的結(jié)果數(shù)據(jù)內(nèi)容。 |
|
Categories | Array of Category | 類目預(yù)測(cè)列表。 |
|
Score | Float | 0.417248 | 分類ID的匹配度,大于0小于等于1。 |
CategoryId | String | 584 | 類目ID。 說明 您可以在 category.txt 文件中查看該接口支持的類目ID和類目名稱。 |
CategoryName | String | 旁軸相機(jī) | 類目名稱。 說明 您可以在 category.txt 文件中查看該接口支持的類目ID和類目名稱。 |
SDK參考
阿里云視覺AI商品理解類目下的商品分類能力推薦使用SDK調(diào)用,支持多種編程語言,調(diào)用時(shí)請(qǐng)選擇AI類目為商品理解(goodstech)的SDK包,文件參數(shù)通過SDK調(diào)用可支持本地文件及任意URL,具體可參見SDK總覽。
示例代碼
該能力常用語言的示例代碼,請(qǐng)參見商品分類示例代碼。
示例
請(qǐng)求示例
http(s)://goodstech.cn-shanghai.aliyuncs.com/?Action=ClassifyCommodity //更多關(guān)于訪問域名(Endpoint)信息,請(qǐng)參見:http://m.bestwisewords.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/goodstech/ClassifyCommodity/ClassifyCommodity1.jpg
&公共請(qǐng)求參數(shù)
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ClassifyCommodityResponse>
<RequestId>87C5AF93-F641-54C2-873D-0501E637489C</RequestId>
<Data>
<Categories>
<CategoryId>584</CategoryId>
<Score>0.417248</Score>
<CategoryName>旁軸相機(jī)</CategoryName>
</Categories>
<Categories>
<CategoryId>4856</CategoryId>
<Score>0.309264</Score>
<CategoryName>數(shù)碼單反</CategoryName>
</Categories>
<Categories>
<CategoryId>733</CategoryId>
<Score>0.103179</Score>
<CategoryName>單電微單</CategoryName>
</Categories>
<Categories>
<CategoryId>5978</CategoryId>
<Score>0.0654835</Score>
<CategoryName>單反鏡頭</CategoryName>
</Categories>
</Data>
</ClassifyCommodityResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "87C5AF93-F641-54C2-873D-0501E637489C",
"Data" : {
"Categories" : [ {
"CategoryId" : 584,
"Score" : 0.417248,
"CategoryName" : "旁軸相機(jī)"
}, {
"CategoryId" : 4856,
"Score" : 0.309264,
"CategoryName" : "數(shù)碼單反"
}, {
"CategoryId" : 733,
"Score" : 0.103179,
"CategoryName" : "單電微單"
}, {
"CategoryId" : 5978,
"Score" : 0.0654835,
"CategoryName" : "單反鏡頭"
} ]
}
}
錯(cuò)誤碼
關(guān)于商品分類的錯(cuò)誤碼,詳情請(qǐng)參見常見錯(cuò)誤碼。
安全聲明
- 請(qǐng)確保上傳的圖片或文件來源符合相應(yīng)的法律法規(guī)。
- 通過體驗(yàn)調(diào)試上傳的臨時(shí)文件有效期為1小時(shí),在24小時(shí)后會(huì)被系統(tǒng)自動(dòng)清理刪除。