bind_face
Makes a clip FOLLOW a tracked face — the way to stick a mask, label or blur onto somebody's head. Movement is relative to where the face was first seen, so the clip keeps the framing it already had and only inherits the motion. Pick what to copy with channels, and what happens while the face is missing with gap. Pass trackId: null to unbind.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gap | No | While the face is missing: 'hold' stays put then jumps, 'hide' disappears, 'glide' travels smoothly to where it reappears. One of: hold | hide | glide. | |
| token | Yes | The session token `connect` returned. Pass it on every call — it says which browser to drive. | |
| clipId | Yes | The clip that should follow the face. | |
| faceId | No | Which person in that run. | |
| smooth | No | Jitter filtering 0–1 (default 0.25). | |
| trackId | No | The run; null unbinds this clip. | |
| channels | No | What to copy: {position, scale, pitch, yaw, roll} booleans. Default position and scale on, the three rotations off. | |
| projectId | Yes | Project id from get_projects. | |
| maxGlideSeconds | No | Longest gap 'glide' will cross before hiding instead (default 1.8). |