DetectImageFaces - 检测图片中的人脸及人脸信息

调用DetectImageFaces接口检测图片中的人脸及人脸信息。

接口说明

该接口不依赖媒体集。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
Projectstring

项目名称。

immimagetest
ImageUristring

图片的OSS URI。

OSS地址规则为oss://bucket/object,其中bucket为和当前项目处于同一区域的OSS Bucket名称,object为文件路径。

oss://imm-test/testcases/facetest.jpg

返回参数

名称类型描述示例值
object
ImageUristring

图片的OSS URI。

oss://imm-test/testcases/facetest.png
RequestIdstring

当次请求的Request ID。

D2C628B8-35DF-473C-8A41-757F30202ADC
Facesarray

人脸识别结果列表。

object
EmotionConfidencenumber

心情置信度。

0.7078456878662109
Attractivenumber

人脸吸引力,分数越高吸引力越强,取值范围为0~1。

0.96
AttractiveConfidencenumber

当前版本不支持此参数。

人脸吸引力置信度。

0.9321795701980591
Genderstring

性别,可选项包括MALE和FEMALE。

FEMALE
AgeConfidencenumber

当前版本不支持此参数。

年龄置信度。

0.9321795701980591
GenderConfidencenumber

性别置信度。

1
FaceIdstring

人脸ID。

59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a0406a51
FaceQualitynumber

人脸质量。

0.9321795701980591
Emotionstring

心情。

HAPPY
Ageinteger

年龄。

29
FaceConfidencenumber

人脸置信度。

0.960875928401947
FaceAttributesobject

人脸其他属性。

GlassesConfidencenumber

是否戴眼镜置信度。

1
Glassesstring

是否带眼镜。

NONE
Maskstring

是否带口罩。

NONE
BeardConfidencenumber

是否有胡子置信度。

1
MaskConfidencenumber

是否带口罩置信度。

1
Beardstring

是否有胡子。

NONE
FaceBoundaryobject

人脸框。

Leftinteger

顶点X坐标,距离左端距离。单位为px。

95
Topinteger

顶点Y坐标,距离顶端距离。单位为px。

191
Widthinteger

人脸框宽度。单位为px。

269
Heightinteger

人脸框高度。单位为px。

252
HeadPoseobject

头部朝向。

Pitchnumber

人脸的俯仰角,取值范围为-180~+180度,可信的范围建议为-30~+30度。

18.38559913635254
Rollnumber

内偏转角,取值范围为-180~+180度,可信的建议范围为-45~+45度。

4.204077243804932
Yawnumber

人脸的左右偏转角,取值范围为-180~+180度,可信的范围建议为-80~+80度。

2.49458646774292
EmotionDetailsobject

七种心情对应的置信度。

HAPPYnumber

HAPPY心情置信度。

0.7078456878662109
CALMnumber

CALM心情置信度。

0.2919808030128479
SURPRISEDnumber

SURPRISED心情置信度。

0.00006672900053672493
DISGUSTEDnumber

DISGUSTED心情置信度。

0.00003373104118509218
ANGRYnumber

ANGRY心情置信度。

0.000012824941222788766
SADnumber

SAD心情置信度。

0.00001525594689155696
SCAREDnumber

SCARED心情置信度。

0.0000014968593404773856

示例

正常返回示例

JSON格式

{
  "ImageUri": "oss://imm-test/testcases/facetest.png",
  "RequestId": "D2C628B8-35DF-473C-8A41-757F30202ADC",
  "Faces": [
    {
      "EmotionConfidence": 0.7078456878662109,
      "Attractive": 0.96,
      "AttractiveConfidence": 0.9321795701980591,
      "Gender": "FEMALE",
      "AgeConfidence": 0.9321795701980591,
      "GenderConfidence": 1,
      "FaceId": "59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a0406a51",
      "FaceQuality": 0.9321795701980591,
      "Emotion": "HAPPY",
      "Age": 29,
      "FaceConfidence": 0.960875928401947,
      "FaceAttributes": {
        "GlassesConfidence": 1,
        "Glasses": "NONE",
        "Mask": "NONE",
        "BeardConfidence": 1,
        "MaskConfidence": 1,
        "Beard": "NONE",
        "FaceBoundary": {
          "Left": 95,
          "Top": 191,
          "Width": 269,
          "Height": 252
        },
        "HeadPose": {
          "Pitch": 18.38559913635254,
          "Roll": 4.204077243804932,
          "Yaw": 2.49458646774292
        }
      },
      "EmotionDetails": {
        "HAPPY": 0.7078456878662109,
        "CALM": 0.2919808030128479,
        "SURPRISED": 0.00006672900053672493,
        "DISGUSTED": 0.00003373104118509218,
        "ANGRY": 0.000012824941222788766,
        "SAD": 0.00001525594689155696,
        "SCARED": 0.0000014968593404773856
      }
    }
  ]
}

错误码

访问错误中心查看更多错误码。

阿里云首页 智能媒体管理 相关技术圈