> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keyframe.art/llms.txt
> Use this file to discover all available pages before exploring further.

# Movie jobs

> How Keyframe creates and tracks generated movies.

# 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`, or `4:5`.
* `style`: natural-language creative direction.

Keyframe may round internal clip lengths to match model constraints. The final timeline still targets the requested story duration.

## Outputs

Completed jobs can expose multiple assets:

* final video export
* generated storyboard frames
* individual video clips
* audio tracks
* review or planning metadata

Use the assets endpoint to list available outputs for a movie.