BlitzReels Video Editor

Generate Faceless Video

generation_faceless_create

DestructiveIdempotent

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

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

Name	Required	Description	Default
`generation`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 26, 2026

changedInput schema / properties / videoModel / enum

Previous value: -[
-  "sync-lipsync-2",
-  "flux-3-max",
-  "heygen-video",
-  "omnihuman-v2",
-  "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",
-  "wan-3.0-prime",
-  "happy-horse",
-  "happy-horse-ref2v",
-  "pixverse-v6",
-  "grok-imagine-lite",
-  "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: +[
+  "sync-lipsync-2",
+  "flux-3-max",
+  "grok-imagine-1.5",
+  "heygen-video",
+  "omnihuman-v2",
+  "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-v4",
+  "kling-v4-ref2v",
+  "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",
+  "wan-3.0-prime",
+  "happy-horse",
+  "happy-horse-ref2v",
+  "pixverse-v6",
+  "grok-imagine-lite",
+  "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",
+  "vidu-q3",
+  "vidu-q3-ref2v"
+]

Changed1 schema field changedOct 24, 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",
-  "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-lite",
-  "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: +[
+  "sync-lipsync-2",
+  "flux-3-max",
+  "heygen-video",
+  "omnihuman-v2",
+  "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",
+  "wan-3.0-prime",
+  "happy-horse",
+  "happy-horse-ref2v",
+  "pixverse-v6",
+  "grok-imagine-lite",
+  "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 changedOct 18, 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",
-  "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",
-  "grok-imagine-lite",
-  "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-lite",
+  "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 changedOct 12, 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",
-  "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",
+  "grok-imagine-lite",
+  "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 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.2/5.0

Behavior4/5

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

Annotations already declare destructiveHint=true, idempotentHint=true, and openWorldHint=true, but the description adds information they cannot convey: the call consumes AI credits, and the result is asynchronous, requiring polling via generation_jobs_get. That credit-cost warning is the highest-value behavioral fact for this tool. It does not describe what project state is created or how failures/credit refunds are handled, keeping it below a 5.

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, zero filler. The pipeline scope is front-loaded and the cost/polling consequence is placed second, which is the right priority order for an agent deciding whether to call.

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?

For an 18-parameter, expensive, asynchronous mutation, the description gives the essentials: what it produces, that it costs credits, and how to retrieve the result. An output schema exists, so return values needn't be spelled out. A note on how seriesId/storyKitId inherit defaults, or expected job duration, would close the remaining gap.

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, including the 58-value videoModel enum and the idempotencyKey retry rule, is already documented in the schema. The description only echoes the feature list (voiceover, captions, music, sound) without adding guidance such as model-selection tradeoffs or how seriesId/storyKitId defaults interact. Baseline 3 applies when the schema carries the semantic load.

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

Purpose5/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 concrete outputs (scene plan, visuals, voiceover, captions, music, sound). This clearly separates it from the granular siblings like generation_video_create, generation_image_create, and video_storyboard_create, which do one piece rather than the whole pipeline.

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?

The description establishes the context of use (script-in, full project out) and the follow-up step ('returns a job to poll with generation_jobs_get'), which is the key routing info an agent needs. It stops short of explicit exclusion language such as 'use generation_voiceover_create / generation_music_create if you only want one asset,' so the boundary with the other generation_* tools is implied rather than stated.

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?