本文介紹添加圖片數(shù)據(jù)AddImage的語法及示例。
功能描述
添加圖片數(shù)據(jù)能力可以為指定數(shù)據(jù)庫添加圖片數(shù)據(jù)。
說明
- 每個數(shù)據(jù)庫最多可以添加5萬張圖片。
- 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等，請通過釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢?nèi)郝?lián)系我們。
服務(wù)說明
視覺搜索服務(wù)將于2023年2月15日起停止更新，后續(xù)不再支持新用戶開通接入服務(wù)，新用戶請使用新版圖像搜索。2023年2月15日之后，會繼續(xù)支持老用戶，老用戶如果對視覺搜索服務(wù)使用有疑問，可通過搜索釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢?nèi)郝?lián)系我們。
輸入限制
- 圖像格式：JPG、JPEG、PNG。
- 圖像大小：不超過2 MB。
- 圖像分辨率：大于128×128像素，小于1024×1024像素。
- URL地址不能包含中文字符。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
| 名稱 | 類型 | 是否必選 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | AddImage | 系統(tǒng)規(guī)定參數(shù)。取值：AddImage。 |
| DbName | String | 是 | default | 數(shù)據(jù)庫名稱。支持小寫字母、數(shù)字、下劃線組合，長度2~64。 |
| ImageUrl | String | 是 | https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/xxxx.png | 圖像URL地址。推薦使用上海地域的OSS鏈接，對于文件在本地或者非上海地域OSS鏈接的情況，請參見文件URL處理。 |
| ExtraData | String | 否 | 風景 | 自定義數(shù)據(jù)。支持字母、數(shù)據(jù)、標點符號、漢字。長度0~512。 |
| EntityId | String | 是 | 001 | 實體ID，可以作為數(shù)據(jù)分組的ID。支持小寫字母、數(shù)字、下劃線的組合，長度1~64。 |
返回數(shù)據(jù)
| 名稱 | 類型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 4DC6BB62-06D1-4242-939A-4AC500662E33 | 請求ID。 |
| Data | Object | 返回的結(jié)果數(shù)據(jù)內(nèi)容。 |
|
| DataId | String | 1585903814940000 | 數(shù)據(jù)ID。 |
SDK參考
阿里云視覺AI能力推薦使用SDK調(diào)用，支持多種編程語言，文件參數(shù)通過SDK調(diào)用可支持本地文件及任意URL，具體可參見SDK總覽。
示例
請求示例
http(s)://imgsearch.cn-shanghai.aliyuncs.com/?Action=AddImage //更多關(guān)于訪問域名（Endpoint）信息，請參見：http://bestwisewords.com/document_detail/143103.html
&DataId=1
&DbName=default
&EntityId=001
&ExtraData=風景
&ImageUrl=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/xxxx.png
&<公共請求參數(shù)>正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RequestId>4DC6BB62-06D1-4242-939A-4AC500662E33</RequestId>
<Data>
<DataId>1585903814940000</DataId>
</Data>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "4DC6BB62-06D1-4242-939A-4AC500662E33",
"Data" : {
"DataId" : "1585903814940000"
}
}錯誤碼
關(guān)于添加圖片數(shù)據(jù)的錯誤碼，詳情請參見常見錯誤碼。
安全聲明
- 請確保上傳的圖片或文件來源符合相應(yīng)的法律法規(guī)。
- 通過體驗調(diào)試上傳的臨時文件有效期為1小時，在24小時后會被系統(tǒng)自動清理刪除。