调用DetectImageFaces检测图片中的人脸及人脸信息_智能媒体管理(IMM)-阿里云帮助中心

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

接口说明

此接口已不再维护，建议使用新版（2020-09-30 版本）接口 DetectImageFaces 。关于新版与旧版 API 的对比，请参见新旧版本使用指引中的新版与旧版 API 对应关系说明章节。
此接口不依赖媒体集。

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
Project	string	是	项目名称。	immimagetest
ImageUri	string	是	图片的 OSS URI。 OSS 地址规则为`oss://bucket/object`，其中 bucket 为和当前项目处于同一区域的 OSS Bucket 名称，object 为文件路径。	oss://imm-test/testcases/facetest.jpg

返回参数

名称	类型	描述	示例值
	object
RequestId	string	当次请求的 Request ID。	D2C628B8-35DF-473C-8A41-757F30202ADC
ImageUri	string	图片的 OSS URI。	oss://imm-test/testcases/facetest.png
Faces	object []	人脸识别结果列表。
AttractiveConfidence	float	当前版本不支持此参数。人脸吸引力置信度。	0.9321795701980591
Gender	string	性别，可选项包括 MALE 和 FEMALE。	FEMALE
GenderConfidence	float	性别置信度。取值范围为[0,1]，数值越大表示结果越可靠。	1
FaceId	string	人脸 ID。	59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a0406a51
FaceAttributes	object	人脸其他属性。
GlassesConfidence	float	是否戴眼镜置信度。取值范围为[0,1]，数值越大表示结果越可靠。	1
Glasses	string	是否带眼镜。	NONE
Mask	string	是否带口罩。	NONE
BeardConfidence	float	是否有胡子置信度。取值范围为[0,1]，数值越大表示结果越可靠。	1
MaskConfidence	float	是否带口罩置信度。取值范围为[0,1]，数值越大表示结果越可靠。	1
FaceBoundary	object	人脸框。
Top	integer	顶点 Y 坐标，距离顶端距离。单位为 px。	191
Width	integer	人脸框宽度。单位为 px。	269
Height	integer	人脸框高度。单位为 px。	252
Left	integer	顶点 X 坐标，距离左端距离。单位为 px。	95
HeadPose	object	头部朝向。
Pitch	float	人脸的俯仰角，取值范围为`-180～+180`度。可信的范围建议为`-30～+30`度，即在该范围内的结果比较可靠。	18.38559913635254
Roll	float	内偏转角，即头部扭转角，取值范围为`-180～+180`度。可信的建议范围为`-45～+45`度，即在该范围内的结果比较可靠。	4.204077243804932
Yaw	float	人脸的左右偏转角，取值范围为`-180～+180`度。可信的范围建议为`-80～+80`度，即在该范围内的结果比较可靠。	2.49458646774292
Beard	string	是否有胡子。	NONE
FaceQuality	float	人脸质量。	0.9321795701980591
Emotion	string	心情。	HAPPY
Age	integer	年龄。	29
FaceConfidence	float	人脸置信度。取值范围为[0,1]，数值越大表示结果越可靠。	0.960875928401947
EmotionConfidence	float	心情置信度。取值范围为[0,1]，数值越大表示结果越可靠。	0.7078456878662109
Attractive	float	人脸吸引力，取值范围为[0,1]，分数越高吸引力越强。	0.96
AgeConfidence	float	当前版本不支持此参数。年龄置信度。	0.9321795701980591
EmotionDetails	object	七种心情对应的置信度。取值范围为[0,1]，数值越大表示结果越可靠。
HAPPY	float	HAPPY 心情置信度。	0.7078456878662109
CALM	float	CALM 心情置信度。	0.2919808030128479
SURPRISED	float	SURPRISED 心情置信度。	0.00006672900053672493
DISGUSTED	float	DISGUSTED 心情置信度。	0.00003373104118509218
ANGRY	float	ANGRY 心情置信度。	0.000012824941222788766
SAD	float	SAD 心情置信度。	0.00001525594689155696
SCARED	float	SCARED 心情置信度。	0.0000014968593404773856

示例

正常返回示例

JSON格式

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

错误码

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