DetectFace人脸检测_Engine处理引擎操作_API手册

描述

检测相片的人脸。

请求参数

名称	类型	是否必填	描述
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 的数组

数据类型SuccessDetail

名称	类型	描述
SrcUri	String	相片源的存储位置
PhotoId	String	相片 ID
Faces	Array	被检测出且加入照片集的人脸 Face 数组，如果没有检测出人脸则为空数组

数据类型FailDetail

名称	类型	描述
SrcUri	String	相片源的存储位置
Reason	String	失败原因

数据类型Face

名称	类型	描述
FaceId	String	人脸 ID
FaceRectangle	Object	人脸矩形框 FaceRectangle
FaceAttribute	Object	人脸属性 FaceAttribute

数据类型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

名称	类型	描述
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	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=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"
    }]
}