Creative
Alphacreative_timeline_plan
Validate a timeline for the connected workspace when its Creative flag is enabled.
Operation Read.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
body | object | Yes | Timeline settings. |
body.audio | object | Yes | Set duration_seconds from 1 to 1800 and choose a saved url, ordered parts, or mode: silence. |
body.video | array | Yes | Provide 1–200 ordered clips or stills. Each needs a source_url, start, and duration. Optional fields include source_in, fit, and the incoming transition. |
body.soundtrack | object | No | Provide a saved audio url with optional gain, looping, fade-out, or ducking under the spine. |
body.output | object | No | Set output geometry, frame rate, and intro or outro fades. The output format is MP4. |
body.render | object | No | Set the render strategy, chunk_max_segments, and short-source pad_mode. |
Plan returns coverage, transition count, render cost estimates, and warnings it can infer from the request. The free check reads the timeline description and returns its result immediately. Render verifies that workspace media exists and can be decoded.
Sample prompt
Check my 75-second timeline with a silent spine and two clips. Tell me the billable minutes before rendering.