調用DetectImageFaces介面檢測圖片中的人臉及其屬性資訊-Intelligent Media Management-阿里雲

檢測指定映像中的人臉邊界資訊、屬性資訊、品質資訊。邊界資訊（Boundary）包括：頂點Y座標距離頂端距離（Top）、頂點X座標距離左端距離（Left）、高度（Height）、寬度（Width）；屬性資訊包括：年齡（Age）、年齡標準差（AgeSD）、性別（Gender）、心情（Emotion）、是否張口（Mouth）、是否有鬍子（Beard）、是否有帽子（Hat）、是否帶口罩（Mask）、是否戴眼鏡（Glasses）、頭部朝向（HeadPose）、人臉吸引力（Attractive）及上述各屬性的信賴度；品質資訊包括：人臉品質分（FaceQuality）、人臉清晰度（Sharpness）。

介面說明

請確保在使用該介面前，已充分瞭解Intelligent Media Management產品的收費方式和價格。
該介面支援的輸入圖片編碼格式請參見圖片限制。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

imm:DetectImageFaces

none

*Project

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

無

請求參數

名稱	類型	必填	描述	樣本值
ProjectName	string	是	專案名稱，擷取方式請參見建立專案。	test-project
SourceURI	string	否	檔案的 OSS 儲存地址。 OSS 地址規則為 oss://${Bucket}/${Object}，其中`${Bucket}`為和當前專案處於同一地區(Region)的 OSS Bucket 名稱，`${Object}`為包含副檔名的檔案完整路徑。	oss://test-bucket/test-object.jpg
CredentialConfig	CredentialConfig	否	如無特殊需求，請保持留空即可。鏈式授權配置，非必填。更多資訊，請參見使用鏈式授權訪問其他實體資源。

返回參數

名稱	類型	描述	樣本值
	object	響應結構體
RequestId	string	當次請求的 Request ID。	6E93D6C9-5AC0-49F9-914D-E02678D3****
Faces	array	圖片人臉資訊列表。
	Figure	人臉詳細資料。

樣本

正常返回樣本

JSON格式

{
  "RequestId": "6E93D6C9-5AC0-49F9-914D-E02678D3****",
  "Faces": [
    {
      "FigureId": "868a9e74-cde5-4c7a-9013-28bb984****",
      "FigureConfidence": 1,
      "FigureClusterId": "Cluster-dbe72fec-b84c-4ab6-885b-3678e64****",
      "FigureClusterConfidence": 1,
      "FigureType": "face",
      "Age": 29,
      "AgeSD": 5,
      "Gender": "female",
      "GenderConfidence": 1,
      "Emotion": "happiness",
      "EmotionConfidence": 0.70784568786621,
      "FaceQuality": 0.960875928401947,
      "Boundary": {
        "Width": 200,
        "Height": 300,
        "Left": 10,
        "Top": 30,
        "Polygon": [
          {
            "X": 10,
            "Y": 10
          }
        ]
      },
      "Mouth": "close",
      "MouthConfidence": 1,
      "Beard": "none",
      "BeardConfidence": 1,
      "Hat": "none",
      "HatConfidence": 1,
      "Mask": "none",
      "MaskConfidence": 1,
      "Glasses": "none",
      "GlassesConfidence": 0.8,
      "Sharpness": 0.7,
      "Attractive": 0.96,
      "HeadPose": {
        "Pitch": 18.385589599609375,
        "Roll": 4.204030513763428,
        "Yaw": 2.4945924282073975
      }
    }
  ]
}

錯誤碼

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

變更歷史

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