The Video Intelligence API **Face detection** feature looks for faces in a video and returns:

- The ,
  or segments in which a face is detected, across all videos in the given request.

- Optional: bounding boxes defining the area of the video frame in which
  the face is detected. To enable this feature, set the
  `includeBoundingBoxes` field in the [`FaceDetectionConfig`](https://docs.cloud.google.com/video-intelligence/docs/reference/rest/v1/videos/annotate.md.txt#facedetectionconfig) to `True`.

- Optional: the detected attributes of the face.
  To enable attribute detection set the `includeAttributes` field within
  [`FaceDetectionConfig`](https://docs.cloud.google.com/video-intelligence/docs/reference/rest/v1/videos/annotate.md.txt#facedetectionconfig)
  to `True`. (note: You must also set`includeBoundingBoxes` to `True`). Also see
  [`DetectedAttribute`](https://docs.cloud.google.com/video-intelligence/docs/reference/rpc/google.cloud.videointelligence.v1.md.txt#detectedattribute).

  Possible boolean attributes:

| Attribute | Description |
|---|---|
| `headwear` | The person is wearing headwear, such as a hat, cap, or scarf. Does not include small objects that hold the hair (e.g., hair pins). |
| `frontal_gaze` | Whether the person's eyes are looking directly into the camera as opposed to simply have both eyes visible. |
| `eyes_visible` | [The sclera](https://en.wikipedia.org/wiki/Sclera) (white of the eye) is visible for both eyes. |
| `glasses` | The person is wearing glasses on their face and over their eyes. The glasses may be clear or colored. Note: Worn in any other way (e.g., top of head, around the neck) the glasses are ignored. |
| `mouth_open` | The person's mouth is open. |
| `smiling` (Deprecated) | **Deprecated:** Effective October 15, 2026, the `smiling` attribute is deprecated and is no longer returned for new projects or projects without recent Face Detection usage. Beginning January 14, 2027, this attribute will be permanently removed for all projects. |

For an example, see
[Face detection](https://docs.cloud.google.com/video-intelligence/docs/face-detection.md.txt).

## Video Intelligence API Visualizer

Check out the [Video Intelligence API visualizer](https://zackakil.github.io/video-intelligence-api-visualiser/#Face%20Detection) to see this feature in action.