圖片查詢
本文介紹圖像搜索服務(wù)的圖片查詢方法。
如需了解更多產(chǎn)品詳情和獲取技術(shù)支持，請單擊在線咨詢或通過釘釘群（35035130）聯(lián)系我們。
背景信息
圖像搜索服務(wù)支持通過API、SDK（推薦方式）和控制臺（適用于功能體驗場景）三種方式進行圖片查詢。
控制臺方式
登錄圖像搜索控制臺。
選擇目標服務(wù)類型和實例。
單擊圖片搜索。
參數(shù)
對應(yīng)API參數(shù)名稱
說明
是否必選
搜索類型
Type
包括兩種搜索類型：
SearchByPic：根據(jù)圖片搜索相似圖片。默認選項。
SearchByName：根據(jù)已添加的圖片搜索相似圖片。
是
上傳圖片
PicContent
圖片內(nèi)容本身，Base64編碼。新增圖片具體要求如下：
圖片大小要求不超過4 MB。
圖片格式：PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。
傳輸?shù)却龝r間不超過5秒。
服務(wù)類型為商品圖片搜索，商標圖片搜索和通用圖片搜索時，圖片長和寬像素要求大于等于100px且小于等于4096px。
服務(wù)類型為布料圖片搜索時，圖片長和寬像素要求大于等于448px且小于等于4096px。
圖片中不能包含旋轉(zhuǎn)信息。
是
圖片主體識別
Crop
在圖片搜索過程中是否需要對上傳圖片進行主體識別。
為true時：進行主體識別，包括系統(tǒng)自動識別和自定義主體識別。具體請參見主體識別方式參數(shù)介紹。
為false時：不進行主體識別，以整張圖進行搜索。
說明對于布料圖片搜索，此參數(shù)會被忽略，系統(tǒng)會以整張圖進行搜索。
是
主體識別方式
不涉及
主體識別的方式：
系統(tǒng)自動識別：由系統(tǒng)自動進行主體識別，以識別的主體進行搜索，主體識別結(jié)果可以在Response中獲取。
自定義主體區(qū)域：可自定義主體識別區(qū)域。格式為
x1,x2,y1,y2，其中x1,y1為左上角點，x2,y2為右下角點。單擊此選項可以通過拖拽的方式框選圖片主體區(qū)域。若不設(shè)置自定義主體區(qū)域，則以整張圖進行搜索。
說明對于布料圖片搜索，此參數(shù)會被忽略，系統(tǒng)會以整張圖進行搜索。
是
圖片類目
CategoryId
圖片類目即CategoryId。圖片搜索過程中可以指定圖片所屬類目，詳情請參見類目參考。
說明對于商品搜索，如果設(shè)置類目，則以設(shè)置的為準；若不設(shè)置類目，將由系統(tǒng)進行類目預測，預測的類目結(jié)果可在Response中獲取 。
對于布料、商標、通用搜索，不論是否設(shè)置類目，系統(tǒng)都會將類目設(shè)置為88888888。
否
返回結(jié)果數(shù)
Num
返回相似結(jié)果的最大值。取值范圍1~100。默認值為10。
否
結(jié)果起始位置
Start
返回相似結(jié)果的起始位置。取值范圍0~499。默認值為0。
是
過濾條件
Filter
搜索時可以設(shè)置過濾條件，只返回符合過濾條件的圖像結(jié)果，比如只返回ownerId為1000的圖像結(jié)果，或者只返回公司名稱為”alibaba”的圖像結(jié)果。
說明int_attr支持的操作符有>、>=、<、<=、=。
str_attr支持的操作符有=和!=。
多個條件之間支持AND和OR進行連接。
例如：int_attr=1000 AND str_attr=”value1”。
否
查看返回結(jié)果。
返回結(jié)果參數(shù)描述如下。
參數(shù)
類型
示例值
說明
Success
Boolean
true
請求是否成功。
RequestId
String
36C43E96-8F68-44AA-B1AF-B1F7AB94A6C1
請求ID。
Code
Integer
0
錯誤碼：
0表示成功。
非0表示失敗。
Message
String
success
錯誤信息。
Head
-
-
搜索結(jié)果信息。
└DocsReturn
Integer
10
返回結(jié)果數(shù)目。
└DocsFound
Integer
10000
實例中命中結(jié)果數(shù)目。
└SearchTime
Integer
95
搜索耗時，單位毫秒。
PicInfo
-
-
類目預測、主體識別結(jié)果等信息。
└CategoryId
Integer
88888888
類目預測結(jié)果。若請求中指定了類目，則以請求中指定為準。
└Region
String
280,486,232,351
主體識別結(jié)果。圖片的主體區(qū)域，格式為x1,x2,y1,y2, 其中x1和y1是左上角的點，x2和y2是右下角的點。若用戶請求中指定了主體區(qū)域，則以請求中指定為準。
└AllCategories
-
-
系統(tǒng)支持的所有類目信息。
└└Name
String
Tops
類目名稱。
└└Id
Integer
0
類目ID。
└MultiRegion
-
-
主體識別結(jié)果集合。
說明需要版本升級至V3.1.1方可使用。
└└Region
String
280,486,232,351
主體識別結(jié)果。圖片的主體區(qū)域，格式為x1,x2,y1,y2,其中x1和y1是左上角的點，x2和y2是右下角的點。若用戶請求中指定了主體區(qū)域，則以請求中指定為準。
Auctions
-
-
所有返回商品的描述信息。
└CustomContent
String
Demo Custom Content
用戶自定義內(nèi)容。
└PicName
String
DemoPic
圖片名稱。
└CategoryId
Integer
0
圖片類目。
└ProductId
String
test
商品ID。
└SortExprValues
String
7.33136443711219e+24;0
系統(tǒng)打分信息。
說明當前字段已棄用，建議使用Score。
└Score
Float
1
圖片相似打分。取值范圍：0~1。
說明需要版本升級至V3.1.1方可使用。
└IntAttr
Integer
0
整數(shù)類型屬性。
└IntAttr2
Integer
0
整數(shù)類型屬性。
說明2023年1月3號之后創(chuàng)建的實例才能使用。
└StrAttr
String
demoStrAttr
字符串類型屬性。
└StrAttr2
String
demoStrAttr
字符串類型屬性。
說明2023年1月3號之后創(chuàng)建的實例才能使用。
API方式
通過HTTP或HTTPS協(xié)議直接訪問，需要按照簽名機制進行身份驗證，發(fā)送請求的RequestBody需要按照給定的格式進行傳輸。通過API查詢相似圖片的QPS為購買的套餐包的QPS。更多詳情請參見根據(jù)名稱查詢圖片或根據(jù)圖片查詢圖片。
SDK方式（推薦）
圖像搜索服務(wù)提供多個版本的SDK，您無需關(guān)注簽名驗證以及RequestBody格式拼裝等繁多設(shè)置。通過SDK查詢相似圖片的QPS為購買的套餐包的QPS。更多詳情請見SDK參考。