全部產品
Search

搜尋本產品

    Image Search：大量操作

    文件中心

    Image Search：大量操作

    更新時間：Jan 20, 2026

    Image Search可以通過大量操作功能大量匯入阿里雲OSS中的圖片，或大量刪除已經入庫的圖片，適用於較大規模的離線圖片資料操作，穩定性高、速度快、操作方便。本文為您介紹如何批量新增和刪除圖片。

    大量操作流程

    1. 開通OSS服務。

    2. 將圖片匯入到OSS中。

    3. 建立increment.meta檔案。

    4. Image Search服務授權。

    5. 建立批量任務。

    開通OSS服務

    如果您尚未開通OSS服務，請參見開通OSS服務進行開通。開通服務後，您還需要建立儲存空間Bucket，具體請參見控制台建立儲存空間。

    說明

    • 開通的OSS為獨立計費，具體計費方式請參見計費概述。

    • 請確保開通的OSS服務以及建立的Bucket與已購買的Image Search服務在同一個地區，否則將無法使用大量操作功能。

    將圖片匯入到OSS中

    匯入圖片，具體操作請參見上傳檔案。

    說明

    圖片存放路徑可以自訂，只需要在建立批量任務時設定圖片路徑即可。

    建立increment.meta檔案

    在OSS服務中存放圖片的路徑下，建立increment.meta檔案，該檔案用來儲存大量操作任務相關內容。

    說明

    1. increment.meta檔案中涉及的圖片必須和increment.meta檔案在同一Bucket下，否則大量操作會失敗。

    2. increment.meta檔案名稱是固定的，Image Search將根據此檔案名稱讀取大量操作相關內容，不要擅自修改檔案名稱，否則會操作失敗。

    3. Image Search支援同一Bucket，不同路徑（path）圖片的大量操作，例如：Bucket為imagesearch，increment.meta檔案在此Bucket的根目錄下，path為girlCloth，圖片在此path目錄下，圖片名稱為girl_cloth8.jpg，則meta檔案中PicName應寫為“PicName":"girlCloth/girl_cloth8.jpg"，注意：必須寫成"girlCloth/girl_cloth8.jpg"，在girlCloth前面和girl_cloth8.jpg後面都不能加正斜線(/)。如果有多級目錄按照此邏輯依次類推。

    4. 在OSS中的圖片名稱尾碼必須填寫，例如圖片名稱為girl_cloth10.jpg，不能寫為"PicName":"girl_cloth10"，必須寫為"PicName":"girl_cloth10.jpg"，否則會處理失敗。

    5. increment.meta檔案中，一行代表處理一張圖片，處理另一張圖片必須換行，不得將所有圖片處理寫到一行中，否則會處理失敗。

    檔案參考樣本如下：

    {"OperationType": "ADD","ProductId": "1000","PicName": "girl_cloth1.jpg","CategoryId": 0,"IntAttr": 0,"StrAttr": "value1","CustomContent": "k1:v1,k2:v2,k3:v3","Region": "20,40,60,80"}
{"OperationType": "ADD","ProductId": "1000","PicName": "girl_cloth2.jpg","CategoryId": 0,"IntAttr": 0,"StrAttr": "value2","CustomContent": "k1:v1,k2:v2,k3:v3","Region": "20,40,60,80"}
{"OperationType": "ADD","ProductId": "1001","PicName": "girl_cloth3.jpg","CategoryId": 1,"CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "ADD","ProductId": "1002","PicName": "girl_cloth4.jpg","CategoryId": 0,"CustomContent": "k1:v1,k2:v2,k3:v3","Crop": false}
{"OperationType": "ADD","ProductId": "1003","PicName": "girl_cloth7.jpg","CustomContent": "https://www.aliyun.com/imagesearch/girl_cloth7.jpg"}
{"OperationType": "ADD","ProductId": "1003","PicName": "girl_cloth6.jpg","CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "ADD","ProductId": "1006","PicName": "girlCloth/girl_cloth10.jpg","CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "DELETE","ProductId": "1004","PicName": "fengyi.jpg"}
{"OperationType": "DELETE","ProductId": "1005"}

    每個圖片由JSON格式表示，具體欄位含義如下表所示：

    參數

    類型

    是否必選

    說明

    OperationType

    String

    是

    操作類型。

    • ADD：新增圖片。

    • DELETE：刪除圖片。

    ProductId

    String

    是

    圖片唯一識別碼，最多支援256個字元。

    PicName

    String

    是

    圖片名稱。OSS的Bucket中圖片名稱。最多支援256個字元。

    重要

    1. 每行最多隻允許填寫1個圖片名稱。若同一個ProductId，對應多個PicName則需要填寫多行。

    2. 圖片名稱必須填寫尾碼，例如：girl_cloth.jpg，不能寫為girl_cloth，必須寫為girl_cloth.jpg，否則會處理失敗。

    3. 如果圖片具有相同的商品ID+圖片名稱，則以最後一次添加為準。即如果圖片具有相同的商品ID+圖片名稱，則不管圖片本身是否相同，後一張圖片都會覆蓋前一張圖片。

    4. 新增圖片具體要求如下

      • 圖片大小要求不超過4 MB。

      • 圖片格式：PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。

      • 傳輸等待時間不超過5秒。

      • 服務類型為商品圖片搜尋、通用圖片搜尋，圖片長和寬像素要求大於等於100且小於等於4096px。

      • 圖片中不能包含旋轉資訊。

    CategoryId

    Integer

    否

    更多說明，請參見類目參考。

    • 對於商品搜尋，如果設定類目，則以設定的為準，並且設定的類目必須在類目參考的範圍之內，否則會入庫失敗。

    • 如果不設定類目，將由系統進行類目預測，預測的類目結果可在Response中擷取。

    • 對於通用搜尋，不論是否設定類目，系統會將類目設定為88888888。

    CustomContent

    String

    是

    使用者自訂內容。最多支援4096個字元。

    說明

    圖片的CustomContent會在搜尋結果中自動關聯出來。通過CustomContent欄位，您可以填寫圖片的URL地址，圖片額外附加資訊等，以便與您的業務關聯。

    IntAttr

    Integer

    否

    整數類型屬性。用於查詢時設定過濾。

    說明

    整數型別屬性與圖片查詢時的過濾條件組合使用，以起到過濾查詢的功能。請參考條件過濾。

    StrAttr

    String

    否

    字串類型屬性。最多支援128字元。用於查詢時設定過濾。

    說明

    • 字串類型屬性與圖片查詢時的過濾條件組合使用，以起到過濾查詢的功能。請參考條件過濾。

    • 不支援特殊字元比如：\¥$&%

    Crop

    Boolean

    否

    是否進行主體識別。預設為true。

    • true：系統自動進行主體識別，以識別的主體進行搜尋。

    • false：不進行主體識別，以整張圖進行搜尋。

    Region

    String

    否

    圖片的主體地區。格式為x1,x2,y1,y2，其中x1和y1是左上方的點，x2和y2是右下角的點。

    說明

    若設定了該參數，則Crop參數不生效，以該設定為準。

    Image Search服務授權

    Image Search服務通過OSS來實現資料大量操作，首次使用需完成帳號一鍵授權。如已完成授權，可跳過此步驟。

    1. 登入Image Search管理主控台。

    2. 選擇目標服務類型和目標執行個體。

    3. 單擊大量操作頁簽。

      大量操作

    4. 單擊建立批量任務，在對話方塊單擊確認一鍵授權。

      一鍵授權

    5. 在雲資源訪問授權頁面單擊確認授權。

      image

    建立批量任務

    1. 登入Image Search管理主控台。

    2. 選擇目標服務類型和目標執行個體。

    3. 單擊大量操作頁簽。

      image

    4. 單擊建立批量任務。

      p278660.png

    5. 設定批量任務參數。

      • 所屬地區

        執行個體所在地區。

      • Bucket名稱

        OSS上建立的相應的Bucket名稱。

        重要

        請確保開通的OSS服務以及建立的Bucket與已購買的Image Search服務在同一個地區。

      • 資料路徑

        需要上傳的圖片和increment.meta檔案的儲存路徑。

        批量上傳.png

      • meta檔案

        需要處理圖片的列表檔案，支援檢測是否存在，檔案名稱為increment.meta。

      • 完成後資訊回調

        輸入回調地址，僅支援HTTP或者HTTPS開頭。

        {
  "finishTime": "2021-05-19 17:50:00",
  "instanceId": "imagesearch-cn-xxxx",
  "instanceName": "instanceName",
  "message": "success",
  "processResultUrl": "https://image-search-task-info.oss-cn-shanghai.aliyuncs.com/yyyyyyyyyy",
  "status": "NORMAL",
  "taskId": 111
}

        欄位名

        描述

        finishTime

        完成時間，精確到秒。

        instanceName

        Image Search執行個體名稱。

        instanceId

        Image Search執行個體ID。

        status

        任務執行結果，NORMAL為正常，FAIL為執行失敗。

        taskId

        任務ID。

        message

        資訊描述；success為成功。

        processResultUrl

        錯誤結果下載。

    取消批量任務

    1. 如需取消“處理中”的批量任務，請單擊取消。image

    2. 閱讀彈窗內容，單擊確定，開始終止批量任務。image

    3. 批量任務取消後，已執行部分會保留，任務狀態變為終止。單擊結果下載，查看具體執行情況。image

    後續步驟

    在執行個體詳情頁，查看所有批量任務的資訊，處理中的批量任務會展示任務進度。批量任務狀態為成功後，使用者可以查看相應的提示資訊：image

    • 可以根據Bucket名稱或者資料路徑進行執行個體查詢。

    • 如果提示資訊為部分照片處理失敗，已為您分離，單擊結果下載，則表明該增量任務中有部分圖片處理失敗，使用者可以下載相應檔案查看處理失敗的原因。