extract media
Pixel operations with no model. From an image: crop a region, or take one panel out of a grid image (the kind a model returns when asked for several options in one picture). From a video: a still at a moment. From a timeline (timeline_id): one frame of the composite as the export shows it, every layer, text and captions, attached to the timeline’s media with lineage to what was on screen, for a poster, a thumbnail source or a reference for generating in the same look. The result is a new library item. Free, except a timeline frame: 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 image or video item. Give this or timeline_id.
A timeline instead of an item: its composite frame at at_time or frame is kept as an image.
crop takes a region of an image. panel takes one cell out of a grid image, the kind a model returns when asked for several options in one picture. frame takes a still out of a video at a moment, and is the mode a timeline_id implies.
crop, panel, frame crop: region as PERCENTAGES (0-100) of the source.
panel: 0-based cell index, row-major. Each cell is inset 2% per edge to avoid grid borders, so compose with margin inside the cell.
panel: grid dimensions (default 2x2).
2x2, 2x3, 3x3 frame: the moment in seconds, in the video or on the timeline (default 0, the first frame).
x >= 0timeline_id: the exact frame number instead of at_time.
x >= 0timeline_id: the item's title. Default: the timeline's name and the timecode.
120timeline_id: folder path or id to file it in. Default: unfiled.
Optional: one sentence shown to the user beside this action.
600
