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

前提条件

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

控制台方式

  1. 登入Image Search控制台
  2. 選擇需要的服務類型。
    關於服務類型的具體說明請參見服務內容1
  3. 單擊目標執行個體。
    2
  4. 選擇圖片新增
    3新增圖片參數設定如下所示。
    參數 對應API參數名稱 說明 是否必選
    商品ID ProductId 商品唯一ID。最多支援256個字元。
    圖片名稱 PicName 圖片名稱,最多支援256個字元。
    说明
    • 商品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服務中。適用於較大規模(百萬級)、離線資料操作。更多詳情請見大量操作