檢測(cè)指定圖像中的人臉邊界信息、屬性信息、質(zhì)量信息。邊界信息（Boundary）包括：頂點(diǎn)Y坐標(biāo)距離頂端距離（Top）、頂點(diǎn)X坐標(biāo)距離左端距離（Left）、高度（Height）、寬度（Width）；屬性信息包括：年齡（Age）、年齡標(biāo)準(zhǔn)差（AgeSD）、性別（Gender）、心情（Emotion）、是否張口（Mouth）、是否有胡子（Beard）、是否有帽子（Hat）、是否帶口罩（Mask）、是否戴眼鏡（Glasses）、頭部朝向（HeadPose）、人臉吸引力（Attractive）及上述各屬性的置信度；質(zhì)量信息包括：人臉質(zhì)量分（FaceQuality）、人臉清晰度（Sharpness）。
接口說明
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別：是指每個(gè)操作的訪問級(jí)別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對(duì)于必選的資源類型，用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| imm:DetectImageFaces | none |
|
| 無 |
請(qǐng)求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ProjectName | string | 是 | 項(xiàng)目名稱，獲取方式請(qǐng)參見創(chuàng)建項(xiàng)目。 | test-project |
| SourceURI | string | 否 | 文件的 OSS 存儲(chǔ)地址。 OSS 地址規(guī)則為 oss://${Bucket}/${Object}，其中 | oss://test-bucket/test-object.jpg |
| CredentialConfig | CredentialConfig | 否 | 如無特殊需求，請(qǐng)保持留空即可。 鏈?zhǔn)绞跈?quán)配置，非必填。更多信息，請(qǐng)參見使用鏈?zhǔn)绞跈?quán)訪問其他實(shí)體資源。 |
返回參數(shù)
示例
正常返回示例
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
}
}
]
}錯(cuò)誤碼
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-04-19 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |