Image Search：圖片新增

控制台方式

1. 登入Image Search控制台。

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。 圖片中不能包含旋轉資訊。 重要 這裡指的是圖片本身，base64編碼。如果您上傳的是圖片URL，請參考SDK中的執行個體代碼Add介面。	是
   圖片主體識別	Crop	是否進行主體識別。	是
   主體識別方式	不涉及	主體識別的方式： 系統自動識別：由系統進行主體識別，以識別的主體進行搜尋，主體識別結果可以在Reponse中擷取。 自訂主體地區：進行主體識別且可自訂主體識別地區。若不設定自訂主體地區，則以整張圖進行搜尋。	是
   圖片類目	CategoryId	新增圖片時可以設定圖片所屬類目。 說明 商品圖片搜尋服務內建了自動類目預測功能，如果此欄位沒有被指定，則上傳圖片後Image Search會預設自動預測圖片所屬類目，並將預測後的類目一併索引到引擎中。預測的類目結果可在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方式

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

大量操作

Image Search服務與阿里雲OSS對接，通過簡單操作即可以將OSS中的圖片大量匯入到Image Search服務中。適用於較大規模（百萬級）、離線資料操作。更多詳情請見大量操作。