BlitzReels models video creation as a set of projects with assets and timeline items. Agents can compose edits deterministically, then export finished videos.

Workspace

Every API key belongs to a workspace. Plan limits, storage, and credits are enforced at the workspace level.

Projects

A project is the unit of video creation. It stores timeline items, captions, and export history.

Typical flow:

Create a project.
Add source media, create a managed clip, or generate content when needed.
Edit the timeline and captions.
Export the final video.

Media Assets

Media assets are files in your workspace library: video, audio, image, or document. Assets are inserted into projects as timeline items.

Timeline Items

Timeline items are clips, overlays, captions, and backgrounds with timing data. You can trim, split, move, and delete them to shape the cut.

Captions and Words

Captions are stored as content items with word-level metadata. This enables word-by-word edits, styling, and transcript corrections.

Jobs

Long-running tasks return a job ID. Poll /v1/jobs/{job_id} or subscribe to webhooks to track progress.

Exports

Exports produce downloadable video files. Download URLs expire, so store the file or re-export as needed.

Core Concepts