track_faces
Finds every FACE in a video clip and stores one independent path per person — position, size and head rotation (nod/turn/tilt) per frame. Queued, not immediate: poll list_face_tracks until state is 'ready'. Re-running on the same clip REPLACES its previous run and keeps the same trackId, so clips already bound stay bound. A person who leaves the shot and returns much later becomes a SECOND face on purpose — use merge_faces if they are the same person.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Display name for the run. | |
| token | Yes | The session token `connect` returned. Pass it on every call — it says which browser to drive. | |
| clipId | Yes | The video clip to scan, from get_timeline. | |
| projectId | Yes | Project id from get_projects. | |
| holdSeconds | No | How long a vanished face is still 'the same face' when it comes back (default 1). | |
| travelFaces | No | How far it may reappear from where it vanished, in face widths (default 0.8). | |
| scoreThreshold | No | Detection confidence floor, 0.3–0.95 (default 0.6). |