The Video Intelligence API Face detection feature looks for faces in a video and returns:
The video segment, 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 theFaceDetectionConfig
toTrue
.Optional: the detected attributes of the face. To enable attribute detection set the
includeAttributes
field withinFaceDetectionConfig
toTrue
. (note: You must also setincludeBoundingBoxes
toTrue
). Also seeDetectedAttribute
.Possible boolean attributes:
Attribute | Description |
---|---|
headwear |
The person is wearing a hat, cap, scarf and so on. 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 (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 |
The person is smiling. |
For an example, see Face detection.
Video Intelligence API Visualizer
Check out the Video Intelligence API visualizer to see this feature in action.