BlitzReels Clipping
Use the managed clip state machine.
It owns ingest, transcription, selection, layout, captions, QA, repair, and export sequencing.
Steps
- Resolve the source as a supported public video URL or workspace asset ID and resolve selection intent.
Use a provided time range or suggestion; use automatic best selection only when choice is delegated.
Complete when source and selection mode are explicit.
- Choose the available surface. Prefer the bundled MCP
clips_create tool; otherwise discover the current contract
with blitzreels agent-context --command "clips create" --json or the OpenAPI /clips operations.
Complete when required inputs, mutation effects, and state fields are known.
- Create with a caller-generated idempotency key.
Complete when the response contains a clip ID, project ID, state, and
next_action.
- For MCP batches, follow
batch.polling with clips_get. For managed API clips, follow next_action: poll,
reselect, repair, export, or stop.
Complete each transition only when the next response advances or reaches a terminal state.
- When the user retained selection choice, present available alternatives with title, hook, range,
duration, and score; reselect the approved ID or range.
Complete when the chosen selection is persisted.
- Validate layout intent.
Tutorial layout is for flattened screen-share plus facecam footage.
Interview and podcast footage use automatic, split, or focus layouts.
Complete when applied layout and content type agree.
- Review QA previews and warnings; run only the repair action offered by current state.
Complete when QA passes or the state reports a specific unresolved block.
- Start a paid export only after user approval and an export-ready state.
Poll to terminal and verify output duration, aspect ratio, captions, framing, and download location.
Manual branch
Use low-level project media, transcript, timeline, caption, and preview operations only when managed state reports
a specific block requiring manual control.
Return to the managed clip after the repair instead of rebuilding its state machine with low-level calls.
Completion
Return clip and project IDs, selected range, applied layout, QA result, warnings, export status,
and download location.
If blocked, return next_action, the exact blocking state, and the user choice or system state required.
Completion requires a verified terminal output or an explicit managed-state blocker.
1---2name: blitzreels-clipping3description: Create, select, reframe, repair, caption, or export short clips from long-form media, including supported YouTube, Instagram, TikTok, X, Facebook, Google Drive, and direct video URLs.4---5
6# BlitzReels Clipping
7
8Use the managed clip **state machine**.
9It owns ingest, transcription, selection, layout, captions, QA, repair, and export sequencing.
10
11## Steps
12
131. Resolve the source as a supported public video URL or workspace asset ID and resolve selection intent.
14 Use a provided time range or suggestion; use automatic best selection only when choice is delegated.
15 Complete when source and selection mode are explicit.
162. Choose the available surface. Prefer the bundled MCP `clips_create` tool; otherwise discover the current contract
17 with `blitzreels agent-context --command "clips create" --json` or the OpenAPI `/clips` operations.
18 Complete when required inputs, mutation effects, and state fields are known.
193. Create with a caller-generated idempotency key.
20 Complete when the response contains a clip ID, project ID, state, and `next_action`.
214. For MCP batches, follow `batch.polling` with `clips_get`. For managed API clips, follow `next_action`: poll,
22 reselect, repair, export, or stop.
23 Complete each transition only when the next response advances or reaches a terminal state.
245. When the user retained selection choice, present available alternatives with title, hook, range,
25 duration, and score; reselect the approved ID or range.
26 Complete when the chosen selection is persisted.
276. Validate layout intent.
28 Tutorial layout is for flattened screen-share plus facecam footage.
29 Interview and podcast footage use automatic, split, or focus layouts.
30 Complete when applied layout and content type agree.
317. Review QA previews and warnings; run only the repair action offered by current state.
32 Complete when QA passes or the state reports a specific unresolved block.
338. Start a paid export only after user approval and an export-ready state.
34 Poll to terminal and verify output duration, aspect ratio, captions, framing, and download location.
35
36## Manual branch
37
38Use low-level project media, transcript, timeline, caption, and preview operations only when managed state reports
39a specific block requiring manual control.
40
41Return to the managed clip after the repair instead of rebuilding its state machine with low-level calls.
42
43## Completion
44
45Return clip and project IDs, selected range, applied layout, QA result, warnings, export status,
46and download location.
47
48If blocked, return `next_action`, the exact blocking state, and the user choice or system state required.
49Completion requires a verified terminal output or an explicit managed-state blocker.
blitzreels