本文介紹搜索圖片SearchImage的語法及示例。
功能描述
搜索圖片能力可以根據(jù)輸入圖片，在數(shù)據(jù)庫中搜索相似的圖片。
說明 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等，請通過釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢群聯(lián)系我們。
服務說明
視覺搜索服務將于2023年2月15日起停止更新，后續(xù)不再支持新用戶開通接入服務，新用戶請使用新版圖像搜索。2023年2月15日之后，會繼續(xù)支持老用戶，老用戶如果對視覺搜索服務使用有疑問，可通過搜索釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢群聯(lián)系我們。
輸入限制
- 圖像格式：JPG、JPEG、PNG。
- 圖像大小：不超過3 MB。
- 圖像分辨率：大于128×128像素，小于1024×1024像素。
- URL地址中不能包含中文字符。
計費說明
關于搜索圖片的計費方式及報價，請參見計費介紹。
說明 下方調試接口為付費接口。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
| 名稱 | 類型 | 是否必選 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | SearchImage | 系統(tǒng)規(guī)定參數(shù)。取值：SearchImage。 |
| DbName | String | 是 | default | 數(shù)據(jù)庫名稱。 |
| ImageUrl | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imgsearch/SearchImage/SearchImage-ku8.png | 圖像URL地址。推薦使用上海地域的OSS鏈接，對于文件在本地或者非上海地域OSS鏈接的情況，請參見文件URL處理。 |
| Limit | Integer | 是 | 5 | 獲取結果數(shù)量上限，取值范圍1~200。 |
返回數(shù)據(jù)
| 名稱 | 類型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | A98DBCEB-45E2-5F5F-B5ED-F2340182FD87 | 請求ID。 |
| Data | Object | 返回的結果數(shù)據(jù)內容。 |
|
| MatchList | Array of MatchList | 相似的圖片列表。 |
|
| ImageUrl | String | http://vision-console.oss-cn-shanghai.aliyuncs.com/1902352443710590/kv6dvd1ie0c6-ipvnszc8584116.jpg?Expires=1635150265&OSSAccessKeyId=LTAI4Fp1Gt5RzwdEXL3o****&Signature=8rj0%2Bxg%2Bni5NxQAcEQqISX5j1w**** | 查找結果，相似圖像的URL地址。 說明
|
| EntityId | String | 123456 | 實體ID。 |
| Score | Float | 10 | 相似得分，取值0~10，分數(shù)越大，相似度越高。 |
| DataId | String | 001 | 數(shù)據(jù)ID。 |
| ExtraData | String | tangyan | 自定義數(shù)據(jù)。 |
SDK參考
阿里云視覺AI能力推薦使用SDK調用，支持多種編程語言，文件參數(shù)通過SDK調用可支持本地文件及任意URL，具體可參見SDK總覽。
示例
請求示例
http(s)://imgsearch.cn-shanghai.aliyuncs.com/?Action=SearchImage //更多關于訪問域名（Endpoint）信息，請參見：http://bestwisewords.com/document_detail/143103.html
&DbName=default
&ImageUrl=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imgsearch/SearchImage/SearchImage-ku8.png
&Limit=5
&<公共請求參數(shù)>正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<SearchImageResponse>
<RequestId>A98DBCEB-45E2-5F5F-B5ED-F2340182FD87</RequestId>
<Data>
<MatchList>
<EntityId>123456</EntityId>
<Score>10</Score>
<DataId>1</DataId>
<ImageUrl>http://vision-console.oss-cn-shanghai.aliyuncs.com/1902352443710590/kv6dvd1ie0c6-ipvnszc8584116.jpg?Expires=1635150265&OSSAccessKeyId=LTAI4Fp1Gt5RzwdEXL3o****&Signature=8rj0%2Bxg%2Bni5NxQAcEQqISX5j1w****</ImageUrl>
<ExtraData>zhaoliu</ExtraData>
</MatchList>
<MatchList>
<EntityId>123457</EntityId>
<Score>1.1762875356333269</Score>
<DataId>2</DataId>
<ImageUrl>http://vision-console.oss-cn-shanghai.aliyuncs.com/1902352443710590/kv6dvd1uimages1.jpg?Expires=1635151060&OSSAccessKeyId=LTAI4Fp1Gt5RzwdEXL3o****&Signature=%2Byceg79YwiShi1RWDSQ%2FSZcIec****</ImageUrl>
<ExtraData>wangwu</ExtraData>
</MatchList>
<MatchList>
<EntityId>123458</EntityId>
<Score>0.9932686334385976</Score>
<DataId>3</DataId>
<ImageUrl>http://vision-console.oss-cn-shanghai.aliyuncs.com/1902352443710590/kv6dvd1ximages2.jpg?Expires=1635151141&OSSAccessKeyId=LTAI4Fp1Gt5RzwdEXL3o****&Signature=rHoEnFco%2BfLWyzHZGFwUpOaySZ****</ImageUrl>
<ExtraData>zhangsan</ExtraData>
</MatchList>
<MatchList>
<EntityId>123459</EntityId>
<Score>1.2938829068163327</Score>
<DataId>4</DataId>
<ImageUrl>http://vision-console.oss-cn-shanghai.aliyuncs.com/1902352443710590/kv6dvd1m641.jpg?Expires=1635150931&OSSAccessKeyId=LTAI4Fp1Gt5RzwdEXL3o****&Signature=5m8NJ50eokih%2Fcxp%2B%2BnsA%2BTT%2BG****</ImageUrl>
<ExtraData>lisi</ExtraData>
</MatchList>
</Data>
</SearchImageResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "A98DBCEB-45E2-5F5F-B5ED-F2340182FD87",
"Data" : {
"MatchList" : [ {
"EntityId" : 123456,
"Score" : 10,
"DataId" : 1,
"ImageUrl" : "http://vision-console.oss-cn-shanghai.aliyuncs.com/1902352443710590/kv6dvd1ie0c6-ipvnszc8584116.jpg?Expires=1635150265&OSSAccessKeyId=LTAI4Fp1Gt5RzwdEXL3o****&Signature=8rj0%2Bxg%2Bni5NxQAcEQqISX5j1w****",
"ExtraData" : "zhaoliu"
}, {
"EntityId" : 123457,
"Score" : 1.1762875356333269,
"DataId" : 2,
"ImageUrl" : "http://vision-console.oss-cn-shanghai.aliyuncs.com/1902352443710590/kv6dvd1uimages1.jpg?Expires=1635151060&OSSAccessKeyId=LTAI4Fp1Gt5RzwdEXL3o****&Signature=%2Byceg79YwiShi1RWDSQ%2FSZcIec****",
"ExtraData" : "wangwu"
}, {
"EntityId" : 123458,
"Score" : 0.9932686334385976,
"DataId" : 3,
"ImageUrl" : "http://vision-console.oss-cn-shanghai.aliyuncs.com/1902352443710590/kv6dvd1ximages2.jpg?Expires=1635151141&OSSAccessKeyId=LTAI4Fp1Gt5RzwdEXL3o****&Signature=rHoEnFco%2BfLWyzHZGFwUpOaySZ****",
"ExtraData" : "zhangsan"
}, {
"EntityId" : 123459,
"Score" : 1.2938829068163327,
"DataId" : 4,
"ImageUrl" : "http://vision-console.oss-cn-shanghai.aliyuncs.com/1902352443710590/kv6dvd1m641.jpg?Expires=1635150931&OSSAccessKeyId=LTAI4Fp1Gt5RzwdEXL3o****&Signature=5m8NJ50eokih%2Fcxp%2B%2BnsA%2BTT%2BG****",
"ExtraData" : "lisi"
} ]
}
}錯誤碼
關于搜索圖片的錯誤碼，詳情請參見常見錯誤碼。
安全聲明
- 請確保上傳的圖片或文件來源符合相應的法律法規(guī)。
- 通過體驗調試上傳的臨時文件有效期為1小時，在24小時后會被系統(tǒng)自動清理刪除。