Video Intelligence API 人脸检测功能会在视频中查找人脸并返回：
在给定请求的所有视频中检测到人脸的视频片段。
可选：边界框，用于定义检测到人脸的视频帧区域。如需启用此功能，请将
FaceDetectionConfig中的includeBoundingBoxes字段设置为True。可选：检测到的人脸的属性。如需启用属性检测，请将
FaceDetectionConfig中的includeAttributes字段设置为True。（注意：您还必须将includeBoundingBoxes设置为True）。另请参阅DetectedAttribute。可能的布尔值属性：
| 特性 | 说明 |
|---|---|
headwear |
人物佩戴着头饰，例如帽子、鸭舌帽或围巾。不包括用于固定头发的小物件（例如发夹）。 |
frontal_gaze |
人的眼睛是否直视镜头，而不是仅仅双眼可见。 |
eyes_visible |
双眼可见巩膜（眼白部分）。 |
glasses |
此人脸上戴上眼镜，遮住了眼睛。眼镜可能是透明的或彩色的。注意：以其他方式（例如，头顶，领子周围）戴的眼镜会被忽略。 |
mouth_open |
人的嘴是张开的。 |
smiling（已弃用） |
已弃用：自 2026 年 10 月 15 日起，smiling 属性已弃用，并且不再针对新项目或最近未使用人脸检测的项目返回。自 2027 年 1 月 14 日起，此属性将从所有项目中永久移除。 |
如需查看示例，请参阅人脸检测。
Video Intelligence API 可视化工具
查看 Video Intelligence API 可视化工具，了解此功能的实际应用情况。