maestro_create_video
Create a complete video from a natural-language brief, with options for language, style, and voice. Get a task ID to monitor rendering progress.
Instructions
Create a complete video or iterate on a prior Maestro video.
The call returns immediately with a task_id. Use maestro_get_task to monitor progress and obtain
each completed language variant's output_url, captions_url, cover_url, duration, and QC score.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| langs | No | Output language codes, such as zh-cn, en, ja, or pt-br. Each language produces a localized video variant. | |
| style | No | Visual style preset. Named presets: cinematic, glass, luxury, swiss, modern, editorial, warm, vibrant, neon, mono, pastel, bold, industrial, futuristic, retro. Use 'auto' or omit to let the server decide. | |
| voice | No | Narration voice preset. Use 'auto' or omit to let the server decide. | |
| action | No | generate creates a new video. remix, edit, and extend iterate on a previous Maestro task and require ref_task_id. | generate |
| aspect | No | Output aspect ratio: 9:16, 16:9, or 1:1. Omit to use the server default (9:16) on a new video, or to inherit the source task's ratio when iterating. | |
| prompt | Yes | Natural-language production brief: topic, audience, scenes, tone, and desired outcome. Maestro plans the script, assets, voiceover, edit, captions, and render. | |
| quality | No | Production tier: lite, standard, or pro. Omit to use the server default (standard) on a new video, or to inherit the source task's tier when iterating. | |
| task_id | No | Optional client-generated UUID. Reusing it is rejected; omit it to let the server generate a task ID. | |
| duration | No | Target video duration in seconds, from 5 to 300. Omit to use the server default (30) on a new video, or to inherit the source task's duration when iterating. | |
| scenario | No | Production workflow: auto, narrated, captions, avatar, or drama. Captions requires a source video in file_urls. Avatar normally needs a portrait in file_urls. Omit to let the server decide. | |
| file_urls | No | Reference image, video, or audio URLs for Maestro to use. | |
| ref_task_id | No | Previous Maestro task ID for remix, edit, or extend. | |
| callback_url | No | Optional webhook URL called when the task succeeds or fails. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |