BlitzReels Generation
Route generation requests through the current public contract.
Full faceless video generation is public; standalone AI Studio media may still require the dashboard.
Workflow
- Load
https://www.blitzreels.com/api/capabilities.json and identify the requested generation branch.
This step is complete when the public operation or exact dashboard fallback is known.
- Inspect only the matching OpenAPI operations and read their current models, limits, and cost guidance.
This step is complete when every planned request field is accepted by the current schema.
- For a full faceless video, read
references/faceless-workflow.md and
references/faceless-prompting.md before creating the plan.
This step is complete when the accepted script and every public operation needed for the run are known.
- For a topic, draft the complete narration first; for supplied narration, retain the user's wording.
This step is complete when the narration and visual cues are ready for immutable planning.
- Create the project with a caller-generated idempotency key, then create its faceless production plan.
This step is complete when the project id, revision id, immutable narration, scene prompts, and cost estimate exist.
- Present the plan, factual-review notes, and cost before paid generation.
After approval, generate character anchors and keyframes, then poll the returned job to a terminal state.
- Inspect every generated asset against its atomic shot contract.
Revise prompts or regenerate targeted assets until every keyframe is approved or its exact mismatch is reported.
- After approval for animation cost, animate the approved assets and poll the job to a terminal state.
Inspect the project timeline, narration joins, generated clip endings, warnings, and media processing state.
- After approval for export cost, export and verify the downloadable output.
Completion requires preview evidence for every scene plus the final export status.
Branches
- Full video from a topic, script, or production brief: use the faceless plan and asset-approval workflow.
- Standalone media: use a public operation when discovery exposes it.
Otherwise return
/dashboard/ai-studio and name the missing public capability.
- CLI generation: read
references/cli-generation.md before choosing a model or
submitting a prompt.
- Carousel: use
blitzreels-carousels.
- Long-form source repurposing: use
blitzreels-clipping.
Generation rules
- Preserve explicit prompts and authored narration; improve derived visual prompts only when requested.
- Read model ids, durations, aspect ratios, voices, and styles from the current schema.
- Use the actual narration duration as timing truth when the brief marks duration as provisional.
- Treat generated assets as pending until both job and media processing states are terminal.
- On an ambiguous timeout, inspect the project and jobs before retrying.
Completion
Return the public operations used, project and job ids, revision id, warnings, cost approvals, preview evidence, and
export status.
An unsupported instruction is complete only when its exact public capability gap is stated.
1---2name: blitzreels-generation3description: Generate AI media with BlitzReels. Use for faceless videos, images, clips, voiceovers, music, SFX, or authored briefs.4---5
6# BlitzReels Generation
7
8Route generation requests through the current public contract.
9Full faceless video generation is public; standalone AI Studio media may still require the dashboard.
10
11## Workflow
12
131. Load `https://www.blitzreels.com/api/capabilities.json` and identify the requested generation branch.
14 This step is complete when the public operation or exact dashboard fallback is known.
152. Inspect only the matching OpenAPI operations and read their current models, limits, and cost guidance.
16 This step is complete when every planned request field is accepted by the current schema.
173. For a full faceless video, read [`references/faceless-workflow.md`](references/faceless-workflow.md) and
18 [`references/faceless-prompting.md`](references/faceless-prompting.md) before creating the plan.
19 This step is complete when the accepted script and every public operation needed for the run are known.
204. For a topic, draft the complete narration first; for supplied narration, retain the user's wording.
21 This step is complete when the narration and visual cues are ready for immutable planning.
225. Create the project with a caller-generated idempotency key, then create its faceless production plan.
23 This step is complete when the project id, revision id, immutable narration, scene prompts, and cost estimate exist.
246. Present the plan, factual-review notes, and cost before paid generation.
25 After approval, generate character anchors and keyframes, then poll the returned job to a terminal state.
267. Inspect every generated asset against its atomic shot contract.
27 Revise prompts or regenerate targeted assets until every keyframe is approved or its exact mismatch is reported.
288. After approval for animation cost, animate the approved assets and poll the job to a terminal state.
29 Inspect the project timeline, narration joins, generated clip endings, warnings, and media processing state.
309. After approval for export cost, export and verify the downloadable output.
31 Completion requires preview evidence for every scene plus the final export status.
32
33## Branches
34
35- Full video from a topic, script, or production brief: use the faceless plan and asset-approval workflow.
36- Standalone media: use a public operation when discovery exposes it.
37 Otherwise return `/dashboard/ai-studio` and name the missing public capability.
38- CLI generation: read [`references/cli-generation.md`](references/cli-generation.md) before choosing a model or
39 submitting a prompt.
40- Carousel: use `blitzreels-carousels`.
41- Long-form source repurposing: use `blitzreels-clipping`.
42
43## Generation rules
44
45- Preserve explicit prompts and authored narration; improve derived visual prompts only when requested.
46- Read model ids, durations, aspect ratios, voices, and styles from the current schema.
47- Use the actual narration duration as timing truth when the brief marks duration as provisional.
48- Treat generated assets as pending until both job and media processing states are terminal.
49- On an ambiguous timeout, inspect the project and jobs before retrying.
50
51## Completion
52
53Return the public operations used, project and job ids, revision id, warnings, cost approvals, preview evidence, and
54export status.
55An unsupported instruction is complete only when its exact public capability gap is stated.
blitzreels