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 Visualizer
請參閱 Video Intelligence API 視覺化工具，瞭解這項功能的實際運作情形。