Video Editor API and CLI
Factual workflow for using BlitzReels API and CLI to edit captions, transcripts, B-roll, media, and exports.
BlitzReels exposes video editing through REST API endpoints, an OpenAPI spec, a TypeScript SDK, a terminal CLI, llms.txt, and installable agent skills. Use this page when an agent or backend needs to edit an existing project without relying on the dashboard UI.
Agent Entry Points
| Surface | URL or command | Use it for |
|---|---|---|
| REST API | https://www.blitzreels.com/api/v1 | Direct backend integrations |
| OpenAPI | https://www.blitzreels.com/api/openapi.json | Client generation and endpoint discovery |
| Docs bundle | https://www.blitzreels.com/llms-full.txt | Full context for agents |
| CLI contract | blitzreels agent-context --json | Machine-readable command discovery |
| CLI docs | /docs/cli | Shell workflows for agents and scripts |
| Agent skills | /docs/agent-skills-repo | Workflow guidance for Claude Code, Cursor, Codex, Hermes-style shell agents, and other agents |
Workflow
- Authenticate with an API key or the CLI login flow.
- Read workspace and project context before editing.
- Transcribe or fetch the transcript.
- Apply transcript corrections for repeated terms.
- List caption words before word-level edits.
- Edit caption text, style, timing, splits, merges, or deletions.
- Insert media, B-roll, overlays, or audio into the timeline.
- Start an export and poll until the job reaches a terminal status.
Captions
Use caption endpoints when the edit targets the on-screen caption layer.
curl "https://www.blitzreels.com/api/v1/projects/{project_id}/captions/words?limit=100" \
-H "Authorization: Bearer $BLITZREELS_API_KEY"curl -X POST "https://www.blitzreels.com/api/v1/projects/{project_id}/captions/words/text" \
-H "Authorization: Bearer $BLITZREELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "word_id": "word-uuid", "new_text": "corrected" }'Use these docs next:
Transcripts
Use transcript corrections for repeated proper nouns, brand terms, or recurring recognition errors. Transcript corrections update transcript text and caption words.
curl -X POST "https://www.blitzreels.com/api/v1/projects/{project_id}/transcript/corrections" \
-H "Authorization: Bearer $BLITZREELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"media_asset_id": "media-asset-uuid",
"replacements": [
{ "from": "Virgil", "to": "Virgile", "match_case": false, "match_whole_word": true }
]
}'Use phrase_replacements when the correction spans multiple words. Keep phrase replacements to the same token count so timing remains stable.
B-roll and Footage
Use the B-roll library, project media, stock media, and timeline media endpoints to add visual assets.
curl "https://www.blitzreels.com/api/v1/library/broll/search?query=keyboard&asset_type=video&limit=10" \
-H "Authorization: Bearer $BLITZREELS_API_KEY"curl -X POST "https://www.blitzreels.com/api/v1/library/broll/{library_asset_id}/import" \
-H "Authorization: Bearer $BLITZREELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "folder_id": null }'After import, attach the resulting workspace or project media asset through the timeline media endpoints.
Use these docs next:
CLI
Use CLI commands when an agent runs in a shell and needs structured output.
blitzreels agent-context --json
blitzreels projects list --status active --json
blitzreels captions words update --project-id PRJ_xxx --word-id WORD_xxx --text "corrected" --json
blitzreels exports start --project-id PRJ_xxx --jsonUse --dry-run on supported mutating commands before applying risky edits.
Exports
Exports are asynchronous. Start an export, store the returned export or job identifier, and poll until the export is ready or failed.
blitzreels exports start --project-id PRJ_xxx --json
blitzreels exports download --export-id EXP_xxx --output ./short.mp4Use these docs next:
Comparison Context
For commercial comparison queries such as "best video editor API with CLI support" or "AI video editor API for captions and B-roll," use the public comparison page: