BlitzReels Video Editor

Generate Faceless Video

generation_faceless_create

Idempotent

Turn a script into a full faceless video project: scene plan, generated visuals, optional voiceover, captions, music, and sound. Spends AI credits and returns a job to poll with generation_jobs_get.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`script`	Yes	The narration or story to turn into a video.
`voiceId`	No	Optional voice override from the BlitzReels voice catalog. The Story Kit narrator voice is used when omitted.
`seriesId`	No	Optional Series UUID. Inherits its Story Kit and branding defaults for this new video.
`storyKitId`	No	Reusable Story Kit UUID for characters, references, locations, style, and narrator voice.
`videoModel`	No	Image-to-video model used to animate scenes.	seedance-2.0-ref2v
`projectName`	No	Name for the created BlitzReels project.	Faceless Video
`visualStyle`	No	Optional art direction override. A Story Kit style is used when omitted.
`workspaceId`	No	Optional workspace ID. Defaults to the user's default workspace. UUID string.
`imageModelId`	No	Model used to generate scene images.	fal-ai/nano-banana-pro
`captionStyleId`	No	Optional caption theme ID from captions_themes_list.
`idempotencyKey`	No	Retry key. Reuse only with identical inputs.
`plannerModelId`	No	Model used to plan the video scenes.	google/gemini-3.8-flash
`includeCaptions`	No	Burn captions into the timeline.
`generateVoiceover`	No	Narrate the script with a generated voice.
`generateSoundEffects`	No	Add generated sound effects.
`targetDurationSeconds`	No	Target runtime between 10 and 120 seconds.
`styleReferenceAssetIds`	No	Optional stills that lock rendering medium, palette, lighting and texture. Not used as scene frames.
`generateBackgroundMusic`	No	Add a generated background track.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`generation`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 28, 2026

changedInput schema / properties / videoModel / enum

Previous value: -[
-  "seedance-2.5-edit",
-  "kling-o3-standard-edit",
-  "kling-o3-pro-edit",
-  "kling-v3-standard-motion-control",
-  "kling-v3-pro-motion-control",
-  "wan-2.2-animate-replace",
-  "kling-2.1",
-  "kling-2.6-pro",
-  "kling-o1",
-  "kling-3.0",
-  "kling-o3-standard",
-  "kling-o3-pro",
-  "kling-o3-4k",
-  "kling-v3-pro",
-  "minimax-01",
-  "minimax-hailuo-02",
-  "minimax-hailuo-2.3-pro",
-  "minimax-h3-max",
-  "luma-ray-2",
-  "luma-ray-3.2",
-  "sora-2",
-  "sora-2-pro",
-  "veo3",
-  "veo3.1",
-  "veo3.1-fast",
-  "gemini-omni-flash-ref2v",
-  "gemini-omni-flash-edit",
-  "gemini-omni-flash",
-  "wan-2.7",
-  "wan-2.7-ref2v",
-  "wan-3.0",
-  "happy-horse",
-  "happy-horse-ref2v",
-  "pixverse-v6",
-  "grok-imagine",
-  "seedance-2.0-pro",
-  "seedance-2.5",
-  "seedance-2.0-pro-fast",
-  "seedance-2.0-ref2v",
-  "seedance-2.0-ref2v-fast",
-  "seedance-1.5-pro",
-  "seedance-1.0-pro",
-  "seedance-1.0-pro-fast",
-  "seedance-1.0-lite",
-  "seedance-1.0-lite-ref2v",
-  "ltx-2-19b",
-  "ltx-2-19b-distilled",
-  "ltx-2.3",
-  "ltx-2.3-fast"
-]New value: +[
+  "seedance-2.5-edit",
+  "kling-o3-standard-edit",
+  "kling-o3-pro-edit",
+  "kling-v3-standard-motion-control",
+  "kling-v3-pro-motion-control",
+  "wan-2.2-animate-replace",
+  "kling-2.1",
+  "kling-2.6-pro",
+  "kling-o1",
+  "kling-3.0",
+  "kling-o3-standard",
+  "kling-o3-pro",
+  "kling-o3-4k",
+  "kling-v3-pro",
+  "minimax-01",
+  "minimax-hailuo-02",
+  "minimax-hailuo-2.3-pro",
+  "minimax-h3-max",
+  "luma-ray-2",
+  "luma-ray-3.2",
+  "veo3",
+  "veo3.1",
+  "veo3.1-fast",
+  "gemini-omni-flash-ref2v",
+  "gemini-omni-flash-edit",
+  "gemini-omni-flash",
+  "wan-2.7",
+  "wan-2.7-ref2v",
+  "wan-3.0",
+  "happy-horse",
+  "happy-horse-ref2v",
+  "pixverse-v6",
+  "grok-imagine",
+  "seedance-2.0-pro",
+  "seedance-2.5",
+  "seedance-2.0-pro-fast",
+  "seedance-2.0-ref2v",
+  "seedance-2.0-ref2v-fast",
+  "seedance-1.5-pro",
+  "seedance-1.0-pro",
+  "seedance-1.0-pro-fast",
+  "seedance-1.0-lite",
+  "seedance-1.0-lite-ref2v",
+  "ltx-2-19b",
+  "ltx-2-19b-distilled",
+  "ltx-2.3",
+  "ltx-2.3-fast"
+]

Changed1 schema field changedSep 21, 2026

changedInput schema / properties / videoModel / enum

Previous value: -[
-  "kling-2.1",
-  "kling-2.6-pro",
-  "kling-o1",
-  "kling-3.0",
-  "kling-o3-standard",
-  "kling-o3-pro",
-  "kling-o3-4k",
-  "kling-v3-pro",
-  "minimax-01",
-  "minimax-hailuo-02",
-  "minimax-hailuo-2.3-pro",
-  "minimax-h3-max",
-  "luma-ray-2",
-  "luma-ray-3.2",
-  "sora-2",
-  "sora-2-pro",
-  "veo3",
-  "veo3.1",
-  "veo3.1-fast",
-  "gemini-omni-flash-ref2v",
-  "gemini-omni-flash-edit",
-  "gemini-omni-flash",
-  "wan-2.7",
-  "wan-2.7-ref2v",
-  "wan-3.0",
-  "happy-horse",
-  "happy-horse-ref2v",
-  "pixverse-v6",
-  "grok-imagine",
-  "seedance-2.0-pro",
-  "seedance-2.5",
-  "seedance-2.0-pro-fast",
-  "seedance-2.0-ref2v",
-  "seedance-2.0-ref2v-fast",
-  "seedance-1.5-pro",
-  "seedance-1.0-pro",
-  "seedance-1.0-pro-fast",
-  "seedance-1.0-lite",
-  "seedance-1.0-lite-ref2v",
-  "ltx-2-19b",
-  "ltx-2-19b-distilled",
-  "ltx-2.3",
-  "ltx-2.3-fast"
-]New value: +[
+  "seedance-2.5-edit",
+  "kling-o3-standard-edit",
+  "kling-o3-pro-edit",
+  "kling-v3-standard-motion-control",
+  "kling-v3-pro-motion-control",
+  "wan-2.2-animate-replace",
+  "kling-2.1",
+  "kling-2.6-pro",
+  "kling-o1",
+  "kling-3.0",
+  "kling-o3-standard",
+  "kling-o3-pro",
+  "kling-o3-4k",
+  "kling-v3-pro",
+  "minimax-01",
+  "minimax-hailuo-02",
+  "minimax-hailuo-2.3-pro",
+  "minimax-h3-max",
+  "luma-ray-2",
+  "luma-ray-3.2",
+  "sora-2",
+  "sora-2-pro",
+  "veo3",
+  "veo3.1",
+  "veo3.1-fast",
+  "gemini-omni-flash-ref2v",
+  "gemini-omni-flash-edit",
+  "gemini-omni-flash",
+  "wan-2.7",
+  "wan-2.7-ref2v",
+  "wan-3.0",
+  "happy-horse",
+  "happy-horse-ref2v",
+  "pixverse-v6",
+  "grok-imagine",
+  "seedance-2.0-pro",
+  "seedance-2.5",
+  "seedance-2.0-pro-fast",
+  "seedance-2.0-ref2v",
+  "seedance-2.0-ref2v-fast",
+  "seedance-1.5-pro",
+  "seedance-1.0-pro",
+  "seedance-1.0-pro-fast",
+  "seedance-1.0-lite",
+  "seedance-1.0-lite-ref2v",
+  "ltx-2-19b",
+  "ltx-2-19b-distilled",
+  "ltx-2.3",
+  "ltx-2.3-fast"
+]

Changed1 schema field changedSep 14, 2026

addedInput schema / properties / styleReferenceAssetIds

Added value: +{
+  "default": [],
+  "description": "Optional stills that lock rendering medium, palette, lighting and texture. Not used as scene frames.",
+  "items": {
+    "format": "uuid",
+    "type": "string"
+  },
+  "maxItems": 10,
+  "type": "array"
+}

Changed2 schema fields changedSep 11, 2026

changedInput schema / properties / plannerModelId / default

Previous value: -"anthropic/claude-opus-4-6"New value: +"google/gemini-3.8-flash"

changedInput schema / properties / videoModel / enum

Previous value: -[
-  "kling-2.1",
-  "kling-2.6-pro",
-  "kling-o1",
-  "kling-3.0",
-  "kling-o3-standard",
-  "kling-o3-pro",
-  "kling-o3-4k",
-  "kling-v3-pro",
-  "minimax-01",
-  "minimax-hailuo-02",
-  "minimax-hailuo-2.3-pro",
-  "minimax-h3-max",
-  "luma-ray-2",
-  "luma-ray-3.2",
-  "sora-2",
-  "sora-2-pro",
-  "veo3",
-  "veo3.1",
-  "veo3.1-fast",
-  "gemini-omni-flash",
-  "wan-2.7",
-  "wan-2.7-ref2v",
-  "wan-3.0",
-  "happy-horse",
-  "happy-horse-ref2v",
-  "pixverse-v6",
-  "grok-imagine",
-  "seedance-2.0-pro",
-  "seedance-2.5",
-  "seedance-2.0-pro-fast",
-  "seedance-2.0-ref2v",
-  "seedance-2.0-ref2v-fast",
-  "seedance-1.5-pro",
-  "seedance-1.0-pro",
-  "seedance-1.0-pro-fast",
-  "seedance-1.0-lite",
-  "seedance-1.0-lite-ref2v",
-  "ltx-2-19b",
-  "ltx-2-19b-distilled",
-  "ltx-2.3",
-  "ltx-2.3-fast"
-]New value: +[
+  "kling-2.1",
+  "kling-2.6-pro",
+  "kling-o1",
+  "kling-3.0",
+  "kling-o3-standard",
+  "kling-o3-pro",
+  "kling-o3-4k",
+  "kling-v3-pro",
+  "minimax-01",
+  "minimax-hailuo-02",
+  "minimax-hailuo-2.3-pro",
+  "minimax-h3-max",
+  "luma-ray-2",
+  "luma-ray-3.2",
+  "sora-2",
+  "sora-2-pro",
+  "veo3",
+  "veo3.1",
+  "veo3.1-fast",
+  "gemini-omni-flash-ref2v",
+  "gemini-omni-flash-edit",
+  "gemini-omni-flash",
+  "wan-2.7",
+  "wan-2.7-ref2v",
+  "wan-3.0",
+  "happy-horse",
+  "happy-horse-ref2v",
+  "pixverse-v6",
+  "grok-imagine",
+  "seedance-2.0-pro",
+  "seedance-2.5",
+  "seedance-2.0-pro-fast",
+  "seedance-2.0-ref2v",
+  "seedance-2.0-ref2v-fast",
+  "seedance-1.5-pro",
+  "seedance-1.0-pro",
+  "seedance-1.0-pro-fast",
+  "seedance-1.0-lite",
+  "seedance-1.0-lite-ref2v",
+  "ltx-2-19b",
+  "ltx-2-19b-distilled",
+  "ltx-2.3",
+  "ltx-2.3-fast"
+]

Changed1 schema field changedSep 10, 2026

addedInput schema / properties / seriesId

Added value: +{
+  "description": "Optional Series UUID. Inherits its Story Kit and branding defaults for this new video.",
+  "type": "string"
+}

Changed1 schema field changedSep 7, 2026

changedInput schema / properties / videoModel / enum

Previous value: -[
-  "kling-2.1",
-  "kling-2.6-pro",
-  "kling-o1",
-  "kling-3.0",
-  "kling-o3-standard",
-  "kling-o3-pro",
-  "kling-o3-4k",
-  "kling-v3-pro",
-  "minimax-01",
-  "minimax-hailuo-02",
-  "minimax-hailuo-2.3-pro",
-  "minimax-h3-max",
-  "luma-ray-2",
-  "luma-ray-3.2",
-  "sora-2",
-  "sora-2-pro",
-  "veo3",
-  "veo3.1",
-  "veo3.1-fast",
-  "gemini-omni-flash",
-  "wan-2.7",
-  "wan-2.7-ref2v",
-  "wan-3.0",
-  "happy-horse",
-  "happy-horse-ref2v",
-  "pixverse-v6",
-  "grok-imagine",
-  "seedance-2.0-pro",
-  "seedance-2.5",
-  "seedance-2.0-pro-fast",
-  "seedance-2.0-ref2v",
-  "seedance-2.0-ref2v-fast",
-  "seedance-1.5-pro",
-  "seedance-1.0-pro",
-  "seedance-1.0-pro-fast",
-  "seedance-1.0-lite",
-  "seedance-1.0-lite-ref2v",
-  "ltx-2-19b",
-  "ltx-2-19b-distilled"
-]New value: +[
+  "kling-2.1",
+  "kling-2.6-pro",
+  "kling-o1",
+  "kling-3.0",
+  "kling-o3-standard",
+  "kling-o3-pro",
+  "kling-o3-4k",
+  "kling-v3-pro",
+  "minimax-01",
+  "minimax-hailuo-02",
+  "minimax-hailuo-2.3-pro",
+  "minimax-h3-max",
+  "luma-ray-2",
+  "luma-ray-3.2",
+  "sora-2",
+  "sora-2-pro",
+  "veo3",
+  "veo3.1",
+  "veo3.1-fast",
+  "gemini-omni-flash",
+  "wan-2.7",
+  "wan-2.7-ref2v",
+  "wan-3.0",
+  "happy-horse",
+  "happy-horse-ref2v",
+  "pixverse-v6",
+  "grok-imagine",
+  "seedance-2.0-pro",
+  "seedance-2.5",
+  "seedance-2.0-pro-fast",
+  "seedance-2.0-ref2v",
+  "seedance-2.0-ref2v-fast",
+  "seedance-1.5-pro",
+  "seedance-1.0-pro",
+  "seedance-1.0-pro-fast",
+  "seedance-1.0-lite",
+  "seedance-1.0-lite-ref2v",
+  "ltx-2-19b",
+  "ltx-2-19b-distilled",
+  "ltx-2.3",
+  "ltx-2.3-fast"
+]

Changed1 schema field changedAug 28, 2026

changedInput schema / properties / videoModel / enum

Previous value: -[
-  "kling-2.1",
-  "kling-2.6-pro",
-  "kling-o1",
-  "kling-3.0",
-  "kling-o3-standard",
-  "kling-o3-pro",
-  "kling-o3-4k",
-  "kling-v3-pro",
-  "minimax-01",
-  "minimax-hailuo-02",
-  "minimax-hailuo-2.3-pro",
-  "luma-ray-2",
-  "luma-ray-3.2",
-  "sora-2",
-  "sora-2-pro",
-  "veo3",
-  "veo3.1",
-  "veo3.1-fast",
-  "gemini-omni-flash",
-  "wan-2.7",
-  "wan-2.7-ref2v",
-  "happy-horse",
-  "happy-horse-ref2v",
-  "pixverse-v6",
-  "grok-imagine",
-  "seedance-2.0-pro",
-  "seedance-2.5",
-  "seedance-2.0-pro-fast",
-  "seedance-2.0-ref2v",
-  "seedance-2.0-ref2v-fast",
-  "seedance-1.5-pro",
-  "seedance-1.0-pro",
-  "seedance-1.0-pro-fast",
-  "seedance-1.0-lite",
-  "seedance-1.0-lite-ref2v",
-  "ltx-2-19b",
-  "ltx-2-19b-distilled"
-]New value: +[
+  "kling-2.1",
+  "kling-2.6-pro",
+  "kling-o1",
+  "kling-3.0",
+  "kling-o3-standard",
+  "kling-o3-pro",
+  "kling-o3-4k",
+  "kling-v3-pro",
+  "minimax-01",
+  "minimax-hailuo-02",
+  "minimax-hailuo-2.3-pro",
+  "minimax-h3-max",
+  "luma-ray-2",
+  "luma-ray-3.2",
+  "sora-2",
+  "sora-2-pro",
+  "veo3",
+  "veo3.1",
+  "veo3.1-fast",
+  "gemini-omni-flash",
+  "wan-2.7",
+  "wan-2.7-ref2v",
+  "wan-3.0",
+  "happy-horse",
+  "happy-horse-ref2v",
+  "pixverse-v6",
+  "grok-imagine",
+  "seedance-2.0-pro",
+  "seedance-2.5",
+  "seedance-2.0-pro-fast",
+  "seedance-2.0-ref2v",
+  "seedance-2.0-ref2v-fast",
+  "seedance-1.5-pro",
+  "seedance-1.0-pro",
+  "seedance-1.0-pro-fast",
+  "seedance-1.0-lite",
+  "seedance-1.0-lite-ref2v",
+  "ltx-2-19b",
+  "ltx-2-19b-distilled"
+]

Changed1 schema field changedAug 26, 2026

changedInput schema / properties / voiceId / description

Previous value: -"Optional voice override. The Story Kit narrator voice is used when omitted."New value: +"Optional voice override from the BlitzReels voice catalog. The Story Kit narrator voice is used when omitted."

Changed6 schema fields changedAug 17, 2026

addedInput schema / properties / storyKitId

Added value: +{
+  "description": "Reusable Story Kit UUID for characters, references, locations, style, and narrator voice.",
+  "type": "string"
+}

removedInput schema / properties / visualStyle / default
```
Removed value: -"cinematic 3D animation"
```

changedInput schema / properties / visualStyle / description

Previous value: -"Art direction for the generated scenes."New value: +"Optional art direction override. A Story Kit style is used when omitted."

changedInput schema / properties / visualStyle / maxLength
```
Previous value: -200New value: +2000
```
removedInput schema / properties / voiceId / default
```
Removed value: -"pNInz6obpgDQGcFmaJgB"
```

changedInput schema / properties / voiceId / description

Previous value: -"Voice ID used when generateVoiceover is true."New value: +"Optional voice override. The Story Kit narrator voice is used when omitted."

Changed1 schema field changedAug 7, 2026

changedInput schema / properties / videoModel / enum

Previous value: -[
-  "kling-2.1",
-  "kling-2.6-pro",
-  "kling-o1",
-  "kling-3.0",
-  "kling-o3-standard",
-  "kling-o3-pro",
-  "kling-o3-4k",
-  "kling-v3-pro",
-  "minimax-01",
-  "minimax-hailuo-02",
-  "minimax-hailuo-2.3-pro",
-  "luma-ray-2",
-  "luma-ray-3.2",
-  "sora-2",
-  "sora-2-pro",
-  "veo3",
-  "veo3.1",
-  "veo3.1-fast",
-  "gemini-omni-flash",
-  "wan-2.7",
-  "wan-2.7-ref2v",
-  "happy-horse",
-  "happy-horse-ref2v",
-  "pixverse-v6",
-  "grok-imagine",
-  "seedance-2.0-pro",
-  "seedance-2.0-pro-fast",
-  "seedance-2.0-ref2v",
-  "seedance-2.0-ref2v-fast",
-  "seedance-1.5-pro",
-  "seedance-1.0-pro",
-  "seedance-1.0-pro-fast",
-  "seedance-1.0-lite",
-  "seedance-1.0-lite-ref2v",
-  "ltx-2-19b",
-  "ltx-2-19b-distilled"
-]New value: +[
+  "kling-2.1",
+  "kling-2.6-pro",
+  "kling-o1",
+  "kling-3.0",
+  "kling-o3-standard",
+  "kling-o3-pro",
+  "kling-o3-4k",
+  "kling-v3-pro",
+  "minimax-01",
+  "minimax-hailuo-02",
+  "minimax-hailuo-2.3-pro",
+  "luma-ray-2",
+  "luma-ray-3.2",
+  "sora-2",
+  "sora-2-pro",
+  "veo3",
+  "veo3.1",
+  "veo3.1-fast",
+  "gemini-omni-flash",
+  "wan-2.7",
+  "wan-2.7-ref2v",
+  "happy-horse",
+  "happy-horse-ref2v",
+  "pixverse-v6",
+  "grok-imagine",
+  "seedance-2.0-pro",
+  "seedance-2.5",
+  "seedance-2.0-pro-fast",
+  "seedance-2.0-ref2v",
+  "seedance-2.0-ref2v-fast",
+  "seedance-1.5-pro",
+  "seedance-1.0-pro",
+  "seedance-1.0-pro-fast",
+  "seedance-1.0-lite",
+  "seedance-1.0-lite-ref2v",
+  "ltx-2-19b",
+  "ltx-2-19b-distilled"
+]

First observedAug 5, 2026

TDQS

A4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare non-read-only, idempotent, non-destructive, open-world behavior, so the bar is lower. The description adds genuinely new facts: the operation consumes AI credits and is asynchronous, returning a job handle. It does not discuss auth requirements or failure/partial-completion behavior, but credit spend and async return are the high-value disclosures here.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, no filler. The pipeline scope is front-loaded and the operational note (credits + polling) is compact and actionable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return-value detail is unnecessary, and the description correctly focuses on scope, cost, and async follow-up. For an 18-parameter, credit-spending orchestrator it covers the essentials, though it could note that most parameters default from Story Kit/branding context to help an agent decide what to omit.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so every one of the 18 parameters is already documented in the schema. The description's mention of voiceover, captions, music, and sound loosely maps to the boolean toggles but adds no syntax, defaults, or constraints beyond what the schema states. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource — 'Turn a script into a full faceless video project' — and enumerates the produced artifacts (scene plan, visuals, voiceover, captions, music, sound), which signals this is a pipeline orchestrator rather than a single-asset generator. It does not name the sibling generators (e.g., generation_video_create) it supersedes, so differentiation is implied rather than explicit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives concrete downstream guidance: the call 'returns a job to poll with generation_jobs_get,' naming the exact follow-up tool. It also flags cost ('Spends AI credits'). It omits when NOT to use it versus the narrower generation_* siblings or workflow_runs_create, but the pipeline framing carries most of that context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All BlitzReels Video Editor tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?