本文介紹Image Search服務的圖片查詢方法。
背景資訊
Image Search服務支援通過API、SDK(推薦方式)和控制台(適用於功能體驗情境)三種方式進行圖片查詢。
控制台方式
選擇目標服務類型和執行個體。
單擊圖片搜尋。
參數
對應API參數名稱
說明
是否必選
搜尋類型
Type
包括兩種搜尋類型:
SearchByPic:根據圖片搜尋相似圖片。預設選項。
SearchByName:根據已添加的圖片搜尋相似圖片。
是
上傳圖片
PicContent
圖片內容本身,Base64編碼。新增圖片具體要求如下:
圖片大小要求不超過4 MB。
圖片格式:PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。
傳輸等待時間不超過5秒。
服務類型為商品圖片搜尋和通用圖片搜尋時,圖片長和寬像素要求大於等於100且小於等於4096。
圖片中不能包含旋轉資訊。
是
圖片主體識別
Crop
在圖片搜尋過程中是否需要對上傳圖片進行主體識別。
為true時:進行主體識別,包括系統自動識別和自訂主體識別。具體請參見主體識別方式參數介紹。
為false時:不進行主體識別,以整張圖進行搜尋。
是
主體識別方式
不涉及
主體識別的方式:
系統自動識別:由系統自動進行主體識別,以識別的主體進行搜尋,主體識別結果可以在Response中擷取。
自訂主體地區:可自訂主體識別地區。格式為
x1,x2,y1,y2
,其中x1,y1
為左上方點,x2,y2
為右下角點。單擊此選項可以通過拖拽的方式框選圖片主體地區。若不設定自訂主體地區,則以整張圖進行搜尋。
是
圖片類目
CategoryId
圖片類目即CategoryId。圖片搜尋過程中可以指定圖片所屬類目,詳情請參見類目參考。
說明對於商品搜尋,如果設定類目,則以設定的為準;若不設定類目,將由系統進行類目預測,預測的類目結果可在Response中擷取 。
對於通用搜尋,不論是否設定類目,系統都會將類目設定為88888888。
否
返回結果數
Num
返回相似結果的最大值。取值範圍1~100。預設值為10。
否
結果起始位置
Start
返回相似結果的起始位置。取值範圍0~499。預設值為0。
否
過濾條件
Filter
搜尋時可以設定過濾條件,只返回符合過濾條件的映像結果,比如只返回ownerId為1000的映像結果,或者只返回公司名稱為”alibaba”的映像結果。
說明int_attr支援的操作符有>、>=、<、<=、=。
str_attr支援的操作符有=和!=。
多個條件之間支援AND和OR進行串連。
例如:int_attr=1000 AND str_attr=”value1”。
否
查看返回結果。
返回結果參數描述如下。
參數
類型
樣本值
說明
Success
Boolean
true
請求是否成功。
RequestId
String
36C43E96-8F68-44AA-B1AF-B1F7AB94A6C1
請求ID。
Code
Integer
0
錯誤碼:
0表示成功。
非0表示失敗。
Message
String
success
錯誤資訊。
Head
-
-
搜尋結果資訊。
└DocsReturn
Integer
10
返回結果數目。
└DocsFound
Integer
10000
執行個體中命中結果數目。
└SearchTime
Integer
95
搜尋耗時,單位毫秒。
PicInfo
-
-
類目預測、主體識別結果等資訊。
└CategoryId
Integer
88888888
類目預測結果。若請求中指定了類目,則以請求中指定為準。
└Region
String
280,486,232,351
主體識別結果。圖片的主體地區,格式為x1,x2,y1,y2, 其中x1和y1是左上方的點,x2和y2是右下角的點。若使用者請求中指定了主體地區,則以請求中指定為準。
└AllCategories
-
-
系統支援的所有類目資訊。
└└Name
String
Tops
類目名稱。
└└Id
Integer
0
類目ID。
└MultiRegion
-
-
主體識別結果集合。
說明需要版本升級至V3.1.1方可使用。
└└Region
String
280,486,232,351
主體識別結果。圖片的主體地區,格式為x1,x2,y1,y2,其中x1和y1是左上方的點,x2和y2是右下角的點。若使用者請求中指定了主體地區,則以請求中指定為準。
Auctions
-
-
所有返回商品的描述資訊。
└CustomContent
String
Demo Custom Content
使用者自訂內容。
└PicName
String
DemoPic
圖片名稱。
└CategoryId
Integer
0
圖片類目。
└ProductId
String
test
商品ID。
└SortExprValues
String
7.33136443711219e+24;0
系統打分資訊。
說明當前欄位已棄用,建議使用Score。
└Score
Float
1
圖片相似打分。取值範圍:0~1。
說明需要版本升級至V3.1.1方可使用。
└IntAttr
Integer
0
整數類型屬性。
└IntAttr2
Integer
0
整數類型屬性。
說明2023年1月3號之後建立的執行個體才能使用。
└StrAttr
String
demoStrAttr
字串類型屬性。
└StrAttr2
String
demoStrAttr
字串類型屬性。
說明2023年1月3號之後建立的執行個體才能使用。
API方式
通過HTTP或HTTPS協議直接存取,需要按照簽名機制進行身分識別驗證,發送請求的RequestBody需要按照給定的格式進行傳輸。通過API查詢相似圖片的QPS為購買的套餐包的QPS。更多詳情請參見根據名稱查詢圖片或根據圖片查詢圖片。
SDK方式(推薦)
Image Search服務提供多個版本的SDK,您無需關注簽名驗證以及RequestBody格式拼裝等繁瑣的事情。通過SDK查詢相似圖片的QPS為購買的套餐包的QPS。更多詳情請見SDK參考。