maestro_create_video
Generate a complete video or iterate on a prior one from a natural-language brief, returning a task ID to monitor progress and retrieve the final output URL.
Instructions
Create a complete video or iterate on a prior Maestro video.
One task delivers one video in one language. Successful jobs cost 0.7 Credits per actual
delivered second, never above the requested duration, with no scenario or language surcharge.
Failed jobs and task polling are free.
The call returns immediately with a task_id. Use maestro_get_task to monitor progress and obtain
the completed video's output_url, captions_url, cover_url, duration, and QC score.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "maestro_create_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| langs | No | Exactly one output language code per task, such as zh-cn, en, ja, or pt-br. | |
| style | No | Visual style preset. Named presets: cinematic, glass, luxury, swiss, modern, editorial, warm, vibrant, neon, mono, pastel, bold, industrial, futuristic, retro. Free text is also accepted as a soft visual hint. Use 'auto' or omit to let the server decide. | |
| voice | No | Narration voice preset or a 32-character hexadecimal voice reference ID. 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. | |
| 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
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |