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 ビジュアライザをご覧いただき、この機能の動作をご確認ください。