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 default: for a key or a connected agent, one of the workspaces the user allowed it.
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
