GetFaceSetDetail_FaceGroup人脸分组操作_图片管理类操作_API手册

描述

获取数据集人脸分组详情。

请求参数

名称	类型	是否必填	描述
Project	String	是	项目名
Action	String	是	GetFaceSetDetail
SetId	String	是	数据集 ID
ReturnAttribute	String	否	是否返回人脸属性， 1，需要返回属性 0，不需要返回属性默认为 0
Marker	String	否	设定后，从人脸ID（FaceId）为Marker的结果开始，以字母顺序返回后续结果。留空从头开始返回结果。

返回参数

名称	类型	描述
RequestId	String	用户发送的每次接口调用请求，无论成功与否，系统都会返回一个唯一识别码 RequestId 给用户
SetId	String	数据集 ID
FaceDetails	Array	人脸 FaceDetail 数组
NextMarker	String	表示下一次操作可以以此为 Marker，将未返回的结果返回，当项目未全部返回时，才有此返回参数

数据类型FaceDetail

名称	类型	描述
FaceId	String	人脸 ID
SrcUri	String	人脸对应的相片资源地址，比如 OSS 地址
PhotoId	String	相片在系统中的 ID
GroupId	String	分组 ID
UnGroupReason	String	如果 GroupId 为 0，此字段表示未能成功分组的原因。 0，人脸图像质量过低 1，人脸图像尺寸过小（高度或宽度） 2，人脸角度过大 3，人脸图像太模糊 4，孤立人脸（无法找到相似人脸） 5，其他原因
FaceRectangle	Object	人脸矩形框 FaceRectangle
FaceAttribute	Object	人脸属性 FaceAttribute，当 ReturnAttribute 为 1 时，才返回

数据类型FaceRectangle

名称	类型	描述
Top	Integer	左上角纵坐标
Left	Integer	左上角横坐标
Width	Integer	宽度
Height	Integer	高度

数据类型FaceAttribute

名称	类型	描述
Gender	Object	性别 Gender
Age	Object	年龄 Age
HeadPose	Object	人脸头部姿势 HeadPose
Eyestatus	Object	眼睛状态 EyeStatus
Blur	Object	人脸模糊度 Blur
FaceQuality	Object	人脸质量 FaceQuality

数据类型Gender

名称	类型	描述
Value	String	性别，Male 代表男性，Female 代表女性

数据类型Age

名称	类型	描述
Value	Integer	标识估计的年龄，为非负整数

数据类型HeadPose

名称	类型	描述
PitchAngle	Float	抬头角度
RollAngle	Float	旋转(平面旋转)角度
YawAngle	Float	摇头角度

数据类型EyeStatus

名称	类型	描述
LeftEyeStatus	Object	左眼状态 OneEyeStatus，每个对象包括多个字段，每个字段的值是一个浮点数，范围[0,100], 小数点后3位有效数字，所有字段总和等于100
RightEyeStatus	Object	右眼状态 OneEyeStatus，每个对象包括多个字段，每个字段的值是一个浮点数，范围[0,100], 小数点后3位有效数字，所有字段总和等于 100

数据类型OneEyeStatus

名称	类型	描述
NormalGlassEyeOpen	Float	佩戴普通眼镜且睁眼的置信度
NoGlassEyeClose	Float	不戴眼镜且闭眼的置信
Occlusion	Float	眼睛被遮挡的置信度
NoGlassEyeOpen	Float	不戴眼镜且睁眼的置信度
NormalGlassEyeClose	Float	佩戴普通眼镜且闭眼的置信度
DarkGlasses	Float	佩戴墨镜的置信度

数据类型Blur

名称	类型	描述
Blurness	Object	模糊度 Blurness

数据类型Blurness

名称	类型	描述
Value	Float	人脸模糊分析结果, 为浮点数，范围[0,100], 小数点后3位有效数字
Threshold	Float	人脸模糊度辨识的阈值

数据类型FaceQuality

名称	类型	描述
Value	Float	人脸的质量判断的分数，为浮点数，范围[0,100], 小数点后3位有效数字
Threshold	Float	脸质量基本合格的一个阈值，超过该阈值的人脸适合用于人脸比对

示例

请求示例

POST https://imm.cn-shanghai.aliyuncs.com
?Action=GetFaceSetDetail
&Project=test
&SetId=1240820b-9e58-472a-b5b1-f0d29e0b2247
...

此处的示例，目的是展示关键参数，还需要其他的公共参数才能正常调用，推荐使用 SDK 来发送 API。

成功返回示例

{
    "RequestId": "FF3B7D81-66AE-47E0-BF69-157DCF187514",
    "SetId": "1240820b-9e58-472a-b5b1-f0d29e0b2247"
    "FaceDetails" :[
        {
            "FaceId": "d203a107c943d47bb0efbb25a16cf84b",
            "SrcUri": "oss://bucket/test.jpg",
            "PhotoId": "13ac5b107c13acb05b107a13acb05",
            "GroupId": 2,
            "FaceRectangle": {
                "Width": 198,
                "Top": 139,
                "Left": 93,
                "Height": 198
            }
        }
    ],
    "NextMarker": ""
}

若在使用中有疑问，请参考 FAQ，或者进入钉钉用户群实时交流。