数据结构

最近更新时间:2019-05-16 20:21:11

Candidate

识别出的最相似候选人

被如下接口引用:SearchFaces。

名称 类型 描述
PersonId String 人员ID
FaceId String 人脸ID
Score Float 候选者的匹配得分。
10万大小人脸库,若人脸均为类似抓拍照(人脸质量较差),
误识率百分之一对应分数为70分,误识率千分之一对应分数为80分,误识率万分之一对应分数为90分;
若人脸均为类似自拍照(人脸质量较好),
误识率百分之一对应分数为60分,误识率千分之一对应分数为70分,误识率万分之一对应分数为80分。
建议分数不要超过90分。您可以根据实际情况选择合适的分数。

FaceAttributesInfo

人脸属性信息,包含性别( gender )、年龄( age )、表情( expression )、 魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息。

被如下接口引用:DetectFace。

名称 类型 描述
Gender Integer 性别 [0(female)~100(male)]。 NeedFaceAttributes 不为 1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
Age Integer 年龄 [0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
Expression Integer 微笑[0(normal)~50(smile)~100(laugh)]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
Glass Boolean 是否有眼镜 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
Pitch Integer 上下偏移[-30,30]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
建议:人脸入库选择[-10,10]的图片。
Yaw Integer 左右偏移[-30,30]。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
建议:人脸入库选择[-10,10]的图片。
Roll Integer 平面旋转[-180,180]。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
建议:人脸入库选择[-20,20]的图片。
Beauty Integer 魅力[0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
Hat Boolean 是否有帽子 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
注意:此字段可能返回 null,表示取不到有效值。
Mask Boolean 是否有口罩 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
注意:此字段可能返回 null,表示取不到有效值。
Hair FaceHairAttributesInfo 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
注意:此字段可能返回 null,表示取不到有效值。
EyeOpen Boolean 双眼是否睁开 [true,false]。只要有超过一只眼睛闭眼,就返回false。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
注意:此字段可能返回 null,表示取不到有效值。

FaceHairAttributesInfo

人脸属性中的发型信息。

被如下接口引用:DetectFace。

名称 类型 描述
Length Integer 0:光头,1:短发,2:中发,3:长发,4:绑发
注意:此字段可能返回 null,表示取不到有效值。
Bang Integer 0:有刘海,1:无刘海
注意:此字段可能返回 null,表示取不到有效值。
Color Integer 0:黑色,1:金色,2:棕色,3:灰白色
注意:此字段可能返回 null,表示取不到有效值。

FaceInfo

人脸信息列表。

被如下接口引用:DetectFace。

名称 类型 描述
X Integer 人脸框左上角横坐标。
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
Y Integer 人脸框左上角纵坐标。
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
Width Integer 人脸框宽度。
Height Integer 人脸框高度。
FaceAttributesInfo FaceAttributesInfo 人脸属性信息,包含性别( gender )、年龄( age )、表情( expression )、
魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
FaceQualityInfo FaceQualityInfo 人脸质量信息,包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。只有当NeedFaceDetection设为1时才返回有效信息。
注意:此字段可能返回 null,表示取不到有效值。

FaceQualityCompleteness

五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。

被如下接口引用:DetectFace。

名称 类型 描述
Eyebrow Integer 眉毛的遮挡分数[0,100],分数越高遮挡越少。
参考范围:[0,80]表示发生遮挡。
注意:此字段可能返回 null,表示取不到有效值。
Eye Integer 眼睛的遮挡分数[0,100],分数越高遮挡越少。
参考范围:[0,80]表示发生遮挡。
注意:此字段可能返回 null,表示取不到有效值。
Nose Integer 鼻子的遮挡分数[0,100],分数越高遮挡越少。
参考范围:[0,60]表示发生遮挡。
注意:此字段可能返回 null,表示取不到有效值。
Cheek Integer 脸颊的遮挡分数[0,100],分数越高遮挡越少。
参考范围:[0,70]表示发生遮挡。
注意:此字段可能返回 null,表示取不到有效值。
Mouth Integer 嘴巴的遮挡分数[0,100],分数越高遮挡越少。
参考范围:[0,50]表示发生遮挡。
注意:此字段可能返回 null,表示取不到有效值。
Chin Integer 下巴的遮挡分数[0,100],分数越高遮挡越少。
参考范围:[0,70]表示发生遮挡。
注意:此字段可能返回 null,表示取不到有效值。

FaceQualityInfo

人脸质量信息,包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。只有当NeedFaceDetection设为1时才返回有效信息。

被如下接口引用:DetectFace。

名称 类型 描述
Score Integer 质量分: [0,100],综合评价图像质量是否适合人脸识别,分数越高质量越好。
参考范围:[0,40]较差,[40,60] 一般,[60,80]较好,[80,100]很好。
建议:人脸入库选取70以上的图片。
注意:此字段可能返回 null,表示取不到有效值。
Sharpness Integer 清晰分:[0,100],评价图片清晰程度,分数越高越清晰。
参考范围:[0,40]特别模糊,[40,60]模糊,[60,80]一般,[80,100]清晰。
建议:人脸入库选取80以上的图片。
注意:此字段可能返回 null,表示取不到有效值。
Brightness Integer 光照分:[0,100],评价图片光照程度,分数越高越亮。
参考范围: [0,30]偏暗,[30,70]光照正常,[70,100]偏亮。
建议:人脸入库选取[30,70]的图片。
注意:此字段可能返回 null,表示取不到有效值。
Completeness FaceQualityCompleteness 五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。
注意:此字段可能返回 null,表示取不到有效值。

FaceRect

检测出的人脸框的位置

被如下接口引用:SearchFaces。

名称 类型 描述
X Integer 人脸框左上角横坐标。
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
Y Integer 人脸框左上角纵坐标。
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
Width Integer 人脸宽度
Height Integer 人脸高度

FaceShape

五官定位(人脸关键点)具体信息。

被如下接口引用:AnalyzeFace。

名称 类型 描述
FaceProfile Array of Point 描述脸型轮廓的 21 点。
LeftEye Array of Point 描述左侧眼睛轮廓的 8 点。
RightEye Array of Point 描述右侧眼睛轮廓的 8 点。
LeftEyeBrow Array of Point 描述左侧眉毛轮廓的 8 点。
RightEyeBrow Array of Point 描述右侧眉毛轮廓的 8 点。
Mouth Array of Point 描述嘴巴轮廓的 22 点。
Nose Array of Point 描述鼻子轮廓的 13 点。
LeftPupil Array of Point 左瞳孔轮廓的 1 个点。
RightPupil Array of Point 右瞳孔轮廓的 1 个点。

GroupExDescriptionInfo

需要修改的人员库自定义描述字段key-value

被如下接口引用:ModifyGroup。

名称 类型 必选 描述
GroupExDescriptionIndex Integer 人员库自定义描述字段Index,从0开始
GroupExDescription String 需要更新的人员库自定义描述字段内容

GroupInfo

返回的人员库信息

被如下接口引用:GetGroupList。

名称 类型 描述
GroupName String 人员库名称
GroupId String 人员库ID
GroupExDescriptions Array of String 人员库自定义描述字段
注意:此字段可能返回 null,表示取不到有效值。
Tag String 人员库信息备注
注意:此字段可能返回 null,表示取不到有效值。

PersonExDescriptionInfo

需要修改的人员描述字段内容,key-value

被如下接口引用:CreatePerson、ModifyPersonGroupInfo。

名称 类型 必选 描述
PersonExDescriptionIndex Integer 人员描述字段Index,从0开始
PersonExDescription String 需要更新的人员描述字段内容

PersonGroupInfo

包含此人员的人员库及描述字段内容列表

被如下接口引用:GetPersonGroupInfo。

名称 类型 描述
GroupId String 包含此人员的人员库ID
PersonExDescriptions Array of String 人员描述字段内容

PersonInfo

返回的人员信息

被如下接口引用:GetPersonList。

名称 类型 描述
PersonName String 人员名称
PersonId String 人员Id
Gender Integer 人员性别
PersonExDescriptions Array of String 人员描述字段内容
FaceIds Array of String 包含的人脸照片列表

Point

坐标

被如下接口引用:AnalyzeFace。

名称 类型 描述
X Integer x坐标
Y Integer Y坐标

Result

人脸的识别结果

被如下接口引用:SearchFaces。

名称 类型 描述
Candidates Array of Candidate 识别出的最相似候选人
FaceRect FaceRect 检测出的人脸框位置