描述
获取数据集人脸分组详情。
请求参数
名称 |
类型 |
是否必填 |
描述 |
Project |
String |
是 |
项目名 |
Action |
String |
是 |
GetFaceSetDetail |
SetId |
String |
是 |
数据集 ID |
ReturnAttribute |
String |
否 |
是否返回人脸属性, 默认为0 |
Marker |
String |
否 |
限定此次返回项目的最大数, 如果不设定,默认为100,MaxKeys 取值不能大于100 |
返回参数
名称 |
类型 |
描述 |
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
名称 |
类型 |
描述 |
value |
String |
性别,Male 代表男性,Female 代表女性 |
数据类型age
名称 |
类型 |
描述 |
value |
Integer |
标识估计的年龄,为非负整数 |
数据类型headpose
名称 |
类型 |
描述 |
pitch_angle |
Float |
抬头角度 |
roll_angle |
Float |
旋转(平面旋转)角度 |
yaw_angle |
Float |
摇头角度 |
数据类型eyestatus
名称 |
类型 |
描述 |
left_eye_status |
Object |
左眼状态 eye_status, 每个对象包括多个字段,每个字段的值是一个浮点数,范围[0,100], 小数点后3位有效数字,所有字段总和等于100 |
right_eye_status |
Object |
右眼状态 eye_status, 每个对象包括多个字段,每个字段的值是一个浮点数,范围[0,100], 小数点后3位有效数字,所有字段总和等于100 |
数据类型eye_status
名称 |
类型 |
描述 |
normal_glass_eye_open |
Float |
佩戴普通眼镜且睁眼的置信度 |
no_glass_eye_close |
Float |
不戴眼镜且闭眼的置信 |
occlusion |
Float |
眼睛被遮挡的置信度 |
no_glass_eye_open |
Float |
不戴眼镜且睁眼的置信度 |
normal_glass_eye_close |
Float |
佩戴普通眼镜且闭眼的置信度 |
dark_glasses |
Float |
佩戴墨镜的置信度 |
数据类型blur
数据类型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
成功返回示例
{
"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": ""
}
在文档使用中是否遇到以下问题
更多建议
匿名提交