控制臺方式

1. 登錄圖像搜索控制臺。

2. 選擇目標服務類型和實例。

3. 單擊圖片搜索。

   

   參數	對應API參數名稱	說明	是否必選
   搜索類型	Type	包括兩種搜索類型： SearchByPic：根據圖片搜索相似圖片。默認選項。 SearchByName：根據已添加的圖片搜索相似圖片。	是
   上傳圖片	PicContent	圖片內容本身，Base64編碼。新增圖片具體要求如下： 圖片大小要求不超過4 MB。 圖片格式：PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。 傳輸等待時間不超過5秒。 服務類型為商品圖片搜索，商標圖片搜索和通用圖片搜索時，圖片長和寬像素要求大于等于100px且小于等于4096px。 服務類型為布料圖片搜索時，圖片長和寬像素要求大于等于448px且小于等于4096px。 圖片中不能包含旋轉信息。	是
   圖片主體識別	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”。	否

4. 查看返回結果。

   返回結果參數描述如下。

   參數	類型	示例值	說明
   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方式（推薦）

圖像搜索服務提供多個版本的SDK，您無需關注簽名驗證以及RequestBody格式拼裝等繁多設置。通過SDK查詢相似圖片的QPS為購買的套餐包的QPS。更多詳情請見SDK參考。