auto reframe
Choose what a clip shows when its picture does not match the box it fills (a 16:9 shot on a 9:16 timeline is centre-cropped by default). view shows one named area of the source, zoomed or not, for the whole clip. Otherwise the crop follows the person, or the largest thing in shot with subject any, cutting rather than panning; two people hold on the larger, or with follow speaker cut to whoever is talking (needs speakers on the recording). A picture that fits, or with nobody found, stays centred and says so. A clip whose subject has not been read yet is read in the background: the answer carries job_id, and the crop lands on the timeline when it finishes (get_jobs). Writes the focus track only, so a punch-in and a camera move stack on it. Reading a subject: cloud processing.
Authorizations
An API key (es_live_…) from Settings, under API keys, or an OAuth access token.
Headers
Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.
The workspace this one call acts in, when it is not the key's own.
Body
The timeline id.
The video clip to reframe. Absent: every video clip on the timeline.
Show one area of the source for the whole clip: its centre as fractions of the source (x 0 left, y 0 top) and, to zoom, its width as a fraction of the source width; no width shows as much as the box holds. Kept inside the picture, up to 5x. Needs clip_id (video or image). Replaces the clip's scale, pan and focus track.
What the crop follows: people (default; a person's head is what it aims at), or any subject, the largest thing detected when no person is in shot.
person, any Where two people share the frame: speaker cuts the crop to whoever is talking, from a speaking-face read at a dozen of each voice's turns, once per recording. Needs speakers on the recording; where it cannot tell, the crop stays centred and says so. Default holds both.
subject, speaker The revision get_timeline returned. A stale one fails with revision_conflict instead of applying; so does no revision once a user edited the timeline in the app since this connection last read it.
Optional: one sentence shown to the user beside this action.
600
