全部產品
Search

搜尋本產品

    ：CreateSimilarImageClusteringTask - 建立相似圖片聚類任務

    文件中心

    ：CreateSimilarImageClusteringTask - 建立相似圖片聚類任務

    更新時間：Jan 29, 2026

    相似圖片聚類功能，可以將您已索引到資料集內的圖片按照相似性產生聚類，用於圖片去重、選優等情境。例如可以通過該功能篩選相簿中連拍的圖片。

    介面說明

    • 請確保在使用該介面前，已充分瞭解Intelligent Media Management產品的收費方式和價格。

      重要 非同步任務不保證時效。

    • 調用該介面前，請確保您已通過綁定方式（ CreateBinding ）或者主動索引（ IndexFileMeta 或者 BatchIndexFileMeta ）方式將檔案索引到資料集（Dataset）中。

    • 每次調用該介面，會增量對資料集Dataset內的檔案進行處理。您可以根據新增檔案情況，定期調用該介面對新檔案進行處理。

    • 聚類完成後，您可以通過 QuerySimilarImageClusters 介面擷取聚類結果。

    • 每組相似圖片聚類限制圖片數量不低於 2 張。從資料集（Dataset）中刪除檔案，會導致相似圖片聚類發生變化。當您從資料集（Dataset）中刪除圖片導致聚類中圖片數小於 2 張時，該聚類會自動刪除。

    • 該介面為非同步介面，擷取任務開始執行後，任務資訊只儲存 7 天，超過 7 天則無法再擷取。調用 GetTask 或 ListTasks 介面擷取返回的TaskId，查看任務資訊。也可以通過設定 Notification 訊息通知參數，通過訊息通知擷取任務資訊。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    imm:CreateSimilarImageClusteringTask

    create

    *Dataset

    acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}/dataset/{#DatasetName}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ProjectName

    string

    是

    專案名稱，擷取方式請參見建立專案。

    test-project
    DatasetName

    string

    是

    資料集名稱，擷取方式請參見建立資料集。

    test-dataset
    UserData

    string

    否

    使用者自訂資訊，在非同步訊息通知中會為您返回，方便您系統內對訊息通知進行關聯處理。最大長度為 2048 位元組。

    test-data
    Tags

    object

    否

    自訂標籤，用於對非同步任務進行搜尋、過濾。

    { "User": "Jane" }
    Notification Notification

    否

    訊息通知配置，詳細內容請單擊 Notification 查看，非同步通知訊息格式請參見非同步通知訊息格式。

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    相似圖片聚類任務資訊。

    RequestId

    string

    請求 ID。

    1B3D5E0A-D8B8-4DA0-8127-ED32C851****
    TaskId

    string

    任務 ID。

    SimilarImageClustering-48d0a0f3-8459-47f4-b8af-ff49c64****
    EventId

    string

    事件 ID。

    3BF-1UhtFyrua71eOkFlqYq23Co****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "1B3D5E0A-D8B8-4DA0-8127-ED32C851****",
  "TaskId": "SimilarImageClustering-48d0a0f3-8459-47f4-b8af-ff49c64****",
  "EventId": "3BF-1UhtFyrua71eOkFlqYq23Co****"
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。