关于人脸检测与五官定位、人体检测能力升级的公告

名称

类型

示例值

描述

RequestId

String

26B5334B-FD8A-5994-A1DA-3CA8F7B25676

请求ID。

Data

Object

返回的结果数据内容。

FaceProbabilityList

Array of Float

0.96

截图中包含人脸的概率，取值范围0~1。如有多个人脸，则依次返回。例如有两个人脸则返回[face_prob1, face_prob2]。图像中人脸区域分辨率越大，人脸越清晰，人脸正视，对应的该值越大。

Pupils

Array of double

[417.83, 226.09, 8.15, 517.46, 231.53, 8.15]

左右两个瞳孔的中心点坐标和半径，每个人脸6个浮点数，顺序为[left_iris_cenpt.x, left_iris_cenpt.y, left_iris_radius, right_iris_cenpt.x, right_iris_cenpt.y, right_iris_radis]。

FaceRectangles

Array of Integer

[358, 141, 207, 255]

返回人脸矩形框，分别是[left, top, width, height]。如有多个人脸，则依次顺延，返回矩形框。例如有两个人脸则返回[left1, top1, width1, height1, left2, top2, width2, height2]。

left-top: 表示以图片左上角为坐标原点，目标框所对应的左上角点位置（x,y），表示框的第一个点距离图片左边界x像素，距离上边界y个像素。

width-height：表示目标框的宽和高。

目标框面积为width*height，目标框右下角坐标为（left+width,top+height）。

FaceCount

Integer

1

检测出的人脸个数。

PoseList

Array of Float

[5.02, -3.95, 2.41]

返回人脸姿态角度，格式为[yaw, pitch, roll]。如有多个人脸，则依次顺延。

• yaw为左右角度，取值范围-90~90。

• pitch为上下角度，取值范围-90~90。

• roll为平面旋转角度，取值范围-180~180。

Landmarks

Array of Float

[381.1, 201.72, 448.09, 205.17, 415.19, 191.2, 415.28, 201.64, 391.35, 196.03, 403.15, 191.57, 426.94, 194.07, 438.42, 197.65, ......]

人脸特征点定位结果，每个人脸返回一组特征点位置，表示方式为（x0, y0, x1, y1, ……）；如有多个人脸，则依次顺延，返回定位浮点数。

LandmarkCount

Integer

105

人脸特征点数目，目前固定为105点。依次为：眉毛24点，眼睛32点，鼻子6点，嘴巴34点，外轮廓9点。

Qualities

Object

人脸质量情况，分数越高表示越有利于识别。

ScoreList

Array of Float

99.92

质量综合分数，分数越高越有利于识别，取值范围(0,100]。如有多张人脸，则依次返回。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片综合质量越高，小于85代表图片综合质量越低。

BlurList

Array of Float

99.21

人脸模糊度对识别的影响分数，分数越高越有利于识别，取值范围(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片模糊的概率越低，小于85代表图片模糊的概率越高。

FnfList

Array of Float

100

目标是否为人脸及其对识别的影响分数，分数越高越有利于识别，取值范围(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片是人脸的概率越高，小于85代表图片是人脸的概率越低。

GlassList

Array of Float

100

眼镜等上半脸遮挡对识别的影响分数，分数越高越有利于识别，取值范围为(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断是否设置阈值及相应阈值大小），大于85代表戴眼镜的概率越低，小于85代表戴眼镜的概率越高。

IlluList

Array of Float

100

光照对识别的影响分数，分数越高越有利于识别，取值范围(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片光照好的概率越高，小于85代表图片光照好的概率越低。

MaskList

Array of Float

99.53

口罩等下半脸遮挡对识别的影响分数，分数越高越有利于识别，取值范围(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表戴口罩概率越低，小于85代表戴口罩概率越高。

NoiseList

Array of Float

99.74

图片噪声对识别的影响分数，分数越高越有利于识别，取值范围(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片有噪声的概率越低，小于85代表图片有噪声的概率越高。

PoseList

Array of Float

100

姿态对识别的影响分数，分数越高越有利于识别，取值范围为(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表人脸姿态正面的概率越高，小于85代表人脸姿态正面的概率越低。

名称

类型

示例值

描述

RequestId

String

26B5334B-FD8A-5994-A1DA-3CA8F7B25676

请求ID。

Data

Object

返回的结果数据内容。

FaceProbabilityList

Array of Float

0.96

截图中包含人脸的概率，取值范围0~1。如有多个人脸，则依次返回。例如有两个人脸则返回[face_prob1, face_prob2]。图像中人脸区域分辨率越大，人脸越清晰，人脸正视，对应的该值越大。

Pupils

Array of double

[417.83, 226.09, 8.15, 517.46, 231.53, 8.15]

左右两个瞳孔的中心点坐标和半径，每个人脸6个浮点数，顺序为[left_iris_cenpt.x, left_iris_cenpt.y, left_iris_radius, right_iris_cenpt.x, right_iris_cenpt.y, right_iris_radis]。

FaceRectangles

Array of Integer

[358, 141, 207, 255]

返回人脸矩形框，分别是[left, top, width, height]。如有多个人脸，则依次顺延，返回矩形框。例如有两个人脸则返回[left1, top1, width1, height1, left2, top2, width2, height2]。

left-top: 表示以图片左上角为坐标原点，目标框所对应的左上角点位置（x,y），表示框的第一个点距离图片左边界x像素，距离上边界y个像素。

width-height：表示目标框的宽和高。

目标框面积为width*height，目标框右下角坐标为（left+width,top+height）。

FaceCount

Integer

1

检测出的人脸个数。

PoseList

Array of Float

[5.02, -3.95, 2.41]

返回人脸姿态角度，格式为[yaw, pitch, roll]。如有多个人脸，则依次顺延。

• yaw为左右角度，取值范围-90~90。

• pitch为上下角度，取值范围-90~90。

• roll为平面旋转角度，取值范围-180~180。

Landmarks

Array of Float

[381.1, 201.72, 448.09, 205.17, 415.19, 191.2, 415.28, 201.64, 391.35, 196.03, 403.15, 191.57, 426.94, 194.07, 438.42, 197.65, ......]

人脸特征点定位结果，每个人脸返回一组特征点位置，表示方式为（x0, y0, x1, y1, ……）；如有多个人脸，则依次顺延，返回定位浮点数。

LandmarkScore

Array of Float

86.89

检测关键点综合分值，取值范围(0,100]，推荐85的阈值，分值越大，质量越高。

LandmarkCount

Integer

105

人脸特征点数目，目前固定为105点。依次为：眉毛24点，眼睛32点，鼻子6点，嘴巴34点，外轮廓9点。

Qualities

Object

人脸质量情况，分数越高表示越有利于识别。

ScoreList

Array of Float

99.92

质量综合分数，分数越高越有利于识别，取值范围(0,100]。如有多张人脸，则依次返回。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片综合质量越高，小于85代表图片综合质量越低。

BlurList

Array of Float

99.21

人脸模糊度对识别的影响分数，分数越高越有利于识别，取值范围(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片模糊的概率越低，小于85代表图片模糊的概率越高。

FnfList

Array of Float

100

目标是否为人脸及其对识别的影响分数，分数越高越有利于识别，取值范围(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片是人脸的概率越高，小于85代表图片是人脸的概率越低。

GlassList

Array of Float

100

眼镜等上半脸遮挡对识别的影响分数，分数越高越有利于识别，取值范围(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表戴眼镜的概率越低，小于85代表戴眼镜的概率越高。

IlluList

Array of Float

100

光照对识别的影响分数，分数越高越有利于识别，取值范围(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片光照好的概率越高，小于85代表图片光照好的概率越低。

MaskList

Array of Float

99.53

口罩等下半脸遮挡对识别的影响分数，分数越高越有利于识别，取值范围(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表戴口罩概率越低，小于85代表戴口罩概率越高。

NoiseList

Array of Float

99.74

图片噪声对识别的影响分数，分数越高越有利于识别，取值范围(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片有噪声的概率越低，小于85代表图片有噪声的概率越高。

PoseList

Array of Float

100

姿态对识别的影响分数，分数越高越有利于识别，取值范围(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断是否设置阈值及相应阈值大小），大于85代表人脸姿态正面的概率越高，小于85代表人脸姿态正面的概率越低。