xPct and yPct are its top-left corner, widthPct and heightPct its size. That is the same space as an overlay’s point and dimensions. The box follows the clip’s layout at that moment: where the camera sits, its shape and crop, mirroring, and Keep face centered. When the layout crops part of a face, the box covers only the visible part. Read the faces again after changing a clip’s layouts.
All times are milliseconds on the clip’s playback timeline — the video as watched, with cuts applied. It is the same timeline as
get_transcript, thumbnails, and previews, so nothing needs converting. A start at or past the end of the clip is rejected with a 400.get_camera_faces
Get the face samples for a clip. A face holds its place until the next sample. Moments when the layout hides the camera are left out, as are faces the layout crops out and unsure detections (usually a hand or a face in the background). Keyframes in cut-out footage are dropped. Returns an empty list when the clip has no camera, or its recording has no face detections yet (still processing, or recorded before face detection).string
required
Video ID
string
required
Clip ID
integer
First time to include, in ms on the clip’s playback timeline (default: clip start). Must be at least 0.
integer
First time to exclude, in ms on the clip’s playback timeline (default: clip end). Must be greater than
startTimeMs.