本文介紹Image Search服務新增圖片的四種方式，通過API新增 、 SDK新增（適用於小規模、即時的資料增量操作）、大量操作（適用於較大規模（百萬級）、離線資料操作）和管控台圖片新增（適用於功能體驗情境）。請根據您的實際情況進行選擇。

前提条件

已建立執行個體，具體請參見開通服務。

控制台方式

  1. 登入Image Search控制台。
  2. 選擇需要的服務類型。
    關於服務類型的具體說明請參見服務內容。1
  3. 單擊目標執行個體。
    2
  4. 選擇圖片新增。
    3新增圖片參數設定如下所示。
    參數 對應API參數名稱 說明 是否必選
    商品ID ProductId 商品唯一ID。最多支援512個字元。 是
    圖片名稱 PicName 圖片名稱，最多支援512個字元。
    说明
    • 商品ID+圖片名稱唯一確定一張圖。
    • 如果圖片具有相同的商品ID+圖片名稱，則以最後一次添加為準。
    		 是
    上傳圖片 PicContent 圖片內容本身，Base64編碼。新增圖片具體要求如下：
    • 圖片大小要求不超過4 MB。
    • 圖片格式：PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。
    • 傳輸等待時間不超過5秒。
    • 服務類型為商品圖片搜尋，商標圖片搜尋和通用圖片搜尋時，圖片長和寬像素要求大於等於100且小於等於4096。
    • 服務類型為布料圖片搜尋時，圖片長和寬像素要求大於等於448且小於等於4096。
    • 圖片中不能包含旋轉資訊。
    		 是
    圖片主體識別 Crop 是否進行主體識別。 是
    主體識別方式 - 主體識別的方式：
    • 系統自動識別：由系統進行主體識別，以識別的主體進行搜尋，主體識別結果可以在Reponse中擷取。
    • 自訂主體地區：進行主體識別且可自訂主體識別地區。若不設定自訂主體地區，則以整張圖進行搜尋。
    		 是
    圖片類目 CategoryId 新增圖片時可以設定圖片所屬類目。 否
    自訂內容 CustomContent 使用者自訂內容，最多支援4096個字元。 否
    整數型屬性 IntAttr 整數類型屬性、用於查詢時過濾。 否
    字串屬性 StrAttr 字串類型屬性。最多支援128個字元。用於查詢時過濾。 否
  5. 單擊確認完成圖片新增。

API方式

通過HTTP或HTTPS協議直接存取，需要按照簽名機制進行身分識別驗證，發送請求的RequestBody需要按照給定的格式進行傳輸。通過API新增圖片預設為5 qps。具體請參見新增圖片。

SDK方式

Image Search服務提供多個版本的SDK，您不需要關注簽名驗證以及RequestBody格式拼裝等繁瑣事情。當圖片量較小且需要即時新增時，推薦使用該種方式。通過SDK新增圖片預設為5 qps。具體請參見SDK參考。

大量操作

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