generationstablevideotextreferenceasync
Generate video
studio_generate_videoText-to-video and image-to-video generation across the Widemile video model catalogue.
Overview
Creates a video clip from a text prompt and/or starting image. Routes to the correct provider for the requested model. Director MCP locks video generation to Seedance 2.0 Fast at 720p while the host agent chooses aspect ratio and duration. Always asynchronous — returns a job_id immediately; poll for completion.
Auth
oauth-jwt
Returns
{ jobId, status, video?: { url } } — poll via `studio_job_status`. Final response includes `creditsRemaining`.
Web client
src/app/[locale]/dashboard/creative-studio/pro-studio/videos/page-client.tsx
MCP handler
https://github.com/PrincipeRosso/wmstudio-director-mcp/blob/main/src/mcp/tools/director-tools.ts
Quick start
Invoke the tool over Streamable HTTP at {MCP_BASE_URL}/mcp/. The request below assumes you already minted an MCP JWT via the OAuth flow.
{
"name": "studio_generate_video",
"arguments": {
"prompt": "<prompt>"
}
}Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| promptrequired | string | — | Text prompt. |
| model | string | "bytedance/seedance-2.0-fast" | Provider/model id. Director MCP locks video generation to Seedance 2.0 Fast. |
| image_url | string | — | Optional starting frame for image-to-video. Must be a real URL; HEAD preflight rejects fabrications. |
| duration | number | 5 | Clip length in seconds (model-dependent ceiling). |
| aspect_ratio | "16:9" | "9:16" | "1:1" | "16:9" | Target aspect ratio. |
Examples
Image-to-video
json
{
"name": "studio_generate_video",
"arguments": {
"prompt": "slow dolly-in, golden hour reflection on the ceramic mug",
"model": "bytedance/seedance-2.0-fast",
"image_url": "https://cdn.wm.studio/uploads/mug.png",
"duration_seconds": 5
}
}