render timeline
Export the timeline: video (mp4), a WebM that keeps its transparency (webm: nothing drawn where no clip is, for a graphic placed over footage in another editor), a GIF, or sound alone (mp3, wav). The render is quoted as a range and settled on what the renderer billed. Returns a job; get_jobs carries the item on success, the newest version of this timeline’s last render of the same kind. check_timeline reports what a render would show wrong. 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.
A key you mint per render (a UUID). The same key on a retry returns the render already dispatched instead of starting a second one; a new render takes a new key.
1 - 200Default 1080p. 4k adds detail only where the sources have it and uses more cloud processing. A render is quoted as a range (color and effects on every clip draw several times a plain cut) and charged on what the renderer billed, never above the range; estimate_cost gives it. One export holds about 3 hours at 1080p or 49 minutes at 4k, less with grain; longer is refused with the length it can do.
1080p, 4k Default mp4. webm keeps the picture's transparency (VP9; the ground is not painted), metered as a video of its size, one pass, so a long cut is refused with the length it can do; the item lands as video tagged transparent. mp3 or wav render the sound alone, metered as a 1080p render; the item lands as audio. gif is silent, about 15 frames a second, at most 720 pixels on the long side and 30 seconds, metered as a 1080p render; the item lands as an image.
mp4, webm, mp3, wav, gif Library folder the finished file lands in, by path ("campaigns/july"), name or id. It has to exist already. Left out, it lands in Timeline renders.
Optional: one sentence shown to the user beside this action.
600
