人脸识别服务 FRS-人脸检测:响应参数

时间:2024-04-29 09:55:57

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

faces

Array of DetectFace objects

检测到的人脸。 调用失败时无此字段。

表5 DetectFace

参数

参数类型

描述

bounding_box

BoundingBox object

人脸在图像中的位置。

attributes

Attributes object

人脸关键属性,比如头部姿态。

表6 BoundingBox

参数

参数类型

描述

width

Integer

人脸图像所在矩形框的宽度。

top_left_y

Integer

矩形框左上角纵坐标。

top_left_x

Integer

矩形框左上角横坐标。

height

Integer

人脸图像所在矩形框的高度。

表7 Attributes

参数

参数类型

描述

dress

Dress object

包含glass和hat两个属性结果。

glass

String

是否带眼镜:

  • yes:带眼镜
  • dark:带墨镜
  • none:未戴眼镜
  • unknown:未知

hat

String

是否戴帽子:

  • yes:戴帽子
  • none:未戴帽子
  • unknown:未知

age

Integer

年龄。

mask

String

是否戴口罩:

  • yes:戴口罩
  • none:未戴口罩
  • unknown:未知

beard

String

胡须:

  • yes:有胡须
  • none:无胡须
  • unknown:未知

phototype

String

图片类型:

  • idcard:证件照
  • monitor:摄像头监控
  • internet photo:网络图片

quality

FaceQuality object

图片中人脸的遮挡度、模糊度、光照强度、姿态角度。

hair

String

发型:

  • long:长发
  • short:短发
  • unknown:未知

expression

expression object

人脸表情,包括中性、高兴、害怕、惊讶、伤心、生气、厌恶。

face_angle

Integer

人脸图片旋转角(顺时针偏转角度),支持0°、90°、180°和270°图片旋转。

表8 Dress

参数

参数类型

描述

glass

String

是否带眼镜:

  • yes:带眼镜
  • dark:带墨镜
  • none:未戴眼镜
  • unknown:未知

hat

String

是否戴帽子:

  • yes:戴帽子
  • none:未戴帽子
  • unknown:未知
表9 FaceQuality

参数

参数类型

描述

推荐值

total_score

Double

人脸质量总分,取值范围[0-1],分值越大质量越高。

大于0.45

blur

Double

模糊度,取值范围[0-1],分值越大模糊问题越严重。

小于0.3

pose

Double

姿态,取值范围[0-1],分值越大姿态问题越严重。

小于0.3

occlusion

Double

遮挡,取值范围[0-1],分值越大遮挡问题越严重。

小于0.3

illumination

Double

光照,取值范围[0-1],分值越大光照问题越严重。

小于0.3

表10 expression

参数

参数类型

描述

type

String

人脸表情类型:

  • neutral:中性
  • happy:高兴
  • fear:害怕
  • surprise:惊讶
  • sad:伤心
  • angry:生气
  • disgust:厌恶
  • unknown:图片质量问题导致未识别

probability

Double

表情置信度,取值范围[0-1]。

状态码: 400

表11 响应Body参数

参数

参数类型

描述

error_code

String

调用失败时的错误码,具体请参考错误码。 调用成功时无此字段。

error_msg

String

调用失败时的错误信息。 调用成功时无此字段。

support.huaweicloud.com/api-face/face_02_0084.html