Movie jobs
A movie is an async job. Creating one starts a pipeline: planning, reference analysis, image generation, video generation, audio, review, stitching, and export.Status values
| Status | Meaning |
|---|---|
queued | The request has been accepted and is waiting to start. |
planning | Keyframe is turning the prompt and references into a production plan. |
generating | Keyframe is generating storyboards, clips, audio, or intermediate assets. |
rendering | Keyframe is assembling the final export. |
completed | The final movie is ready. |
failed | The job failed and includes an error object. |
canceled | The job was canceled before completion. |
Duration and aspect ratio
v1 starts with simple constraints:duration_seconds: target story duration.aspect_ratio:16:9,9:16,1:1, or4:5.style: natural-language creative direction.
Outputs
Completed jobs can expose multiple assets:- final video export
- generated storyboard frames
- individual video clips
- audio tracks
- review or planning metadata