控制臺方式

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

2. 在左側導航欄中，選擇需要的服務類型。本文以商品圖片搜索為例介紹。

   關于服務類型的具體說明請參見服務內容。

3. 單擊目標實例。

   

4. 選擇圖片新增。

   新增圖片參數設置如下所示。

   參數	對應API參數名稱	說明	是否必選
   商品ID	ProductId	商品唯一ID。最多支持256個字符。	是
   圖片名稱	PicName	圖片名稱，最多支持256個字符。 說明 商品ID+圖片名稱唯一確定一張圖。 重要 如果圖片具有相同的商品ID+圖片名稱，則以最后一次添加為準。即如果圖片具有相同的商品ID+圖片名稱，則不管圖片本身是否相同，后一張圖片都會覆蓋前一張圖片。	是
   上傳圖片	PicContent	圖片內容本身，Base64編碼。新增圖片具體要求如下： 圖片大小要求不超過4 MB。 圖片格式：PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。 傳輸等待時間不超過5秒。 服務類型為商品圖片搜索、通用圖片搜索、家具家居圖片搜索、工業五金圖片搜索時，圖片長和寬像素要求大于等于100且小于等于4096px。 服務類型為商標圖片搜索時，圖片長和寬像素要求大于等于200且小于等于4096px。 服務類型為布料圖片搜索時，圖片長和寬像素要求大于等于448且小于等于4096px。 圖片中不能包含旋轉信息。 重要 這里指的是圖片本身，base64編碼。如果您上傳的是圖片URL，請參考SDK中的實例代碼Add接口。	是
   圖片主體識別	Crop	是否進行主體識別。	是
   主體識別方式	不涉及	主體識別的方式： 系統自動識別：由系統進行主體識別，以識別的主體進行搜索，主體識別結果可以在Response中獲取。 自定義主體區域：進行主體識別且可自定義主體識別區域。若不設置自定義主體區域，則以整張圖進行搜索。	是
   圖片類目	CategoryId	新增圖片時可以設置圖片所屬類目。 說明 商品圖片搜索服務內置了自動類目預測功能，如果此字段沒有被指定，則上傳圖片后圖像搜索會默認自動預測圖片所屬類目，并將預測后的類目一并索引到引擎中。預測的類目結果可在Response中獲取。 在搜索過程中商品圖片搜索服務也會對圖片進行自動類目預測，并在預測后的類目中進行相似圖片搜索，以此來縮小搜索范圍提高搜索準確度。 對于商品圖片搜索服務，建議選擇默認的自動類目預測功能。 對于布料、商標、通用搜索、版權、工業五金、家具家居圖片搜索，不論是否設置類目，系統都會將類目設置為88888888。 類目列表請參見類目參考。 重要 如果在上傳圖片過程中指定了類目，則在搜索過程中也要指定相同的類目進行檢索，否則會出現原圖搜不到原圖的情況。	否
   自定義內容	CustomContent	用戶自定義內容，最多支持4096個字符。 說明 圖片的CustomContent會在搜索結果中自動關聯出來。通過CustomContent字段，您可以填寫圖片的URL地址，圖片額外附加信息等，以便與您的業務關聯。	否
   整數型屬性	IntAttr	整數類型屬性、用于查詢時過濾。 說明 整型類型屬性與圖片查詢時的過濾條件組合使用，以起到過濾查詢的功能。請參考條件過濾。	否
   整數型屬性	IntAttr2	整數類型屬性、用于查詢時過濾。 說明 整型類型屬性與圖片查詢時的過濾條件組合使用，以起到過濾查詢的功能。請參考條件過濾。 2023年1月3號之后創建的實例才能使用。	否
   字符串屬性	StrAttr	字符串類型屬性。最多支持128個字符。用于查詢時過濾。 說明 字符串類型屬性與圖片查詢時的過濾條件組合使用，以起到過濾查詢的功能。請參考條件過濾。	否
   字符串屬性	StrAttr2	字符串類型屬性。最多支持128個字符。用于查詢時過濾。 說明 字符串類型屬性與圖片查詢時的過濾條件組合使用，以起到過濾查詢的功能。請參考條件過濾。 2023年1月3號之后創建的實例才能使用。	否

5. 單擊確認完成圖片新增。

API方式

通過HTTP或HTTPS協議直接訪問，需要按照簽名機制進行身份驗證，發送請求的RequestBody需要按照給定的格式進行傳輸。通過API新增圖片默認為5 QPS。具體請參見新增圖片。

SDK方式

圖像搜索服務提供多個版本的SDK，您不需要關注簽名驗證以及RequestBody格式拼裝等繁瑣事情。當圖片量較小且需要實時新增時，推薦使用該種方式。通過SDK新增圖片，10W規格套餐為1 QPS，其余套餐規格均為5 QPS。具體請參見Add接口。

批量操作

圖像搜索服務與阿里云OSS對接，通過簡單操作即可以將OSS中的圖片批量導入到圖像搜索服務中。適用于較大規模（百萬級）、離線數據操作。更多詳情請見批量操作。