检测相片的人脸。
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
Project | String | 是 | 项目名 |
Action | String | 是 | DetectFace |
SrcUris | String | 是 | 相片源的存储位置,例如 OSS 资源”oss://bucket1/a.jpg” 。 支持批量文件传入,一次最多支持10张相片,以 JSON 字符串的方式表示,例如: [ “oss://bucket1/1.jpg”, “oss://bucket1/2.jpg” ] |
名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码 RequestId 给用户 |
SrcUris | String | 相片源的存储位置, 以 JSON 字符串的方式表示,例如: [ “oss://bucket1/1.jpg” ] |
SuccessDetails | Array | 成功识别详细信息 SuccessDetail 数组 |
FailDetails | Array | 相片识别失败原因 FailDetail 的数组 |
名称 | 类型 | 描述 |
---|---|---|
SrcUri | String | 相片源的存储位置 |
PhotoId | String | 相片 ID |
Faces | Array | 被检测出且加入照片集的人脸 Face 数组, 如果没有检测出人脸则为空数组 |
名称 | 类型 | 描述 |
---|---|---|
SrcUri | String | 相片源的存储位置 |
Reason | String | 失败原因 |
名称 | 类型 | 描述 |
---|---|---|
FaceId | String | 人脸 ID |
FaceRectangle | Object | 人脸矩形框 FaceRectangle |
FaceAttribute | Object | 人脸属性 FaceAttribute |
名称 | 类型 | 描述 |
---|---|---|
top | Integer | 左上角纵坐标 |
left | Integer | 左上角横坐标 |
width | Integer | 宽度 |
height | Integer | 高度 |
名称 | 类型 | 描述 |
---|---|---|
gender | Object | 性别 gender |
age | Object | 年龄 age |
headpose | Object | 人脸头部姿势 headpose |
eyestatus | Object | 眼睛状态 eyestatus |
blur | Object | 人脸模糊度 blur |
facequality | Object | 人脸质量 facequality |
名称 | 类型 | 描述 |
---|---|---|
value | String | 性别,Male 代表男性,Female 代表女性 |
名称 | 类型 | 描述 |
---|---|---|
value | Integer | 标识估计的年龄,为非负整数 |
名称 | 类型 | 描述 |
---|---|---|
pitch_angle | Float | 抬头角度 |
roll_angle | Float | 旋转(平面旋转)角度 |
yaw_angle | Float | 摇头角度 |
名称 | 类型 | 描述 |
---|---|---|
left_eye_status | Object | 左眼状态 eye_status, 每个对象包括多个字段,每个字段的值是一个浮点数,范围[0,100], 小数点后3位有效数字,所有字段总和等于100 |
right_eye_status | Object | 右眼状态 eye_status, 每个对象包括多个字段,每个字段的值是一个浮点数,范围[0,100], 小数点后3位有效数字,所有字段总和等于100 |
名称 | 类型 | 描述 |
---|---|---|
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 | 佩戴墨镜的置信度 |
名称 | 类型 | 描述 |
---|---|---|
blurness | Object | 模糊度 blurness |
名称 | 类型 | 描述 |
---|---|---|
value | Float | 人脸模糊分析结果, 为浮点数,范围 [0,100], 小数点后3位有效数字 |
threshold | Float | 人脸模糊度辨识的阈值 |
名称 | 类型 | 描述 |
---|---|---|
value | Float | 人脸的质量判断的分数,为浮点数,范围[0,100], 小数点后3位有效数字 |
threshold | Float | 脸质量基本合格的一个阈值, 超过该阈值的人脸适合用于人脸比对 |
POST https://imm.cn-shanghai.aliyuncs.com?Action=DetectFace
&Project=test
&SrcUris=["oss://bucket1/A.jpg",,"oss://bucket1/B.jpg"]
{
"RequestId": "FF3B7D81-66AE-47E0-BF69-157DCF187514",
"SrcUris": ["oss://bucket1/A.jpg"],
"SuccFaces": [{
"SrcUri": "oss://bucket1/A.jpg",
"PhotoId": "42fb0d5bf81c5ac57c52344dddc3e7c9 ",
"Faces": [
{
"FaceAttribute": {
"gender": {
"value": "Female"
},
"age": {
"value": 21
}
"headpose": {
"yaw_angle": -26.625063,
"pitch_angle": 12.921974,
"roll_angle": 22.814377
},
"eyestatus": {
"left_eye_status": {
"normal_glass_eye_open": 0.062,
"no_glass_eye_close": 0,
"occlusion": 0,
"no_glass_eye_open": 99.938,
"normal_glass_eye_close": 0,
"dark_glasses": 0
},
"right_eye_status": {
"normal_glass_eye_open": 0.082,
"no_glass_eye_close": 0,
"occlusion": 0,
"no_glass_eye_open": 99.918,
"normal_glass_eye_close": 0,
"dark_glasses": 0
}
},
"blur": {
"blurness": {
"threshold": 50,
"value": 0.395
}
},
"facequality": {
"threshold": 70.1,
"value": 89.062
}
},
"FaceRectangle": {
"width": 140,
"top": 89,
"left": 104,
"height": 141
},
"FaceId": "ed319e807e039ae669a4d1af0922a0c8"
}
]
}],
"FailDetail": [{
"SrcUri": "oss://bucket1/B.jpg",
"Reason": "PhotoSizeTooLarge"
}]
}
在文档使用中是否遇到以下问题
更多建议
匿名提交