imagestableimagereferencenine-panelbatch
Storyboard
studio_storyboardUpload an image, describe a story, and get 9 coherent shots.
Overview
Backed by the Widemile Gridshot tool. Generates a 3×3 storyboard grid of shots that preserve the subject and progress the described story across panels.
Auth
oauth-jwt
Returns
{ job_id, status, panels?: [{ url, index, caption }] }
Web client
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_storyboard",
"arguments": {
"reference_image_url": "<reference_image_url>",
"story": "<story>"
}
}Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| reference_image_urlrequired | string | — | Source image for the opening shot. |
| storyrequired | string | — | Narrative the storyboard should follow. |
| style | string | "" | Visual style hint. |
| mood | string | "" | Mood hint. |
Examples
9-shot storyboard
json
{
"name": "studio_storyboard",
"arguments": {
"reference_image_url": "https://cdn.wm.studio/uploads/hero.jpg",
"story": "Athlete laces up before dawn, runs the empty city, finishes at sunrise on the bridge.",
"style": "cinematic 35mm",
"mood": "determined"
}
}