全部產品
Search

搜尋本產品

    ：CompareImageFaces - 圖片人臉相似性比對

    文件中心

    ：CompareImageFaces - 圖片人臉相似性比對

    更新時間：Feb 26, 2026

    比較兩張圖片中最大的人臉的相似性。最大的人臉指的是圖片經臉部偵測後，所有人臉框中面積最大的。

    介面說明

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

    • 對於輸入的圖片，只會選取圖片中人臉框範圍最大的人臉進行人臉比較。人臉框檢測結果與 DetectImageFaces 一致。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    imm:CompareImageFaces

    none

    *Project

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

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ProjectName

    string

    是

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

    test-project
    CredentialConfig CredentialConfig

    否

    如無特殊需求，請保持留空即可。

    鏈式授權配置，非必填。更多資訊，請參見使用鏈式授權訪問其他實體資源。

    Source

    object

    否

    對比的兩張圖片地址。

    URI1

    string

    否

    圖片的 OSS 地址。

    地址規則為oss://<bucket>/<object>，其中<bucket>為和當前專案處於同一地區的 OSS Bucket 名稱，<object>為包含副檔名的檔案完整路徑。

    oss://test-bucket/test-object1
    URI2

    string

    否

    圖片的 OSS 地址。

    地址規則為oss://<bucket>/<object>，其中<bucket>為和當前專案處於同一地區的 OSS Bucket 名稱，<object>為包含副檔名的檔案完整路徑。

    oss://test-bucket/test-object2

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    響應結構體。

    RequestId

    string

    當次請求的 Request ID。

    F73AC982-2B9E-4ECD-AED5-F8331C5******
    Similarity

    number

    人臉相似性，該值越大則人臉相似性越高，取值範圍為 0～1。

    0.8848152756690983

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "F73AC982-2B9E-4ECD-AED5-F8331C5******",
  "Similarity": 0.8848152756690983
}

    錯誤碼

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

    變更歷史

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