imagestableimagereferenceoutpaint
Expand Image
studio_expand_imageOutpaint an image in any direction.
Overview
Extends the canvas of a source image by N pixels (or a target ratio) on any side. Uses the same outpainting pipeline as the Widemile Expand tool.
Auth
oauth-jwt
Returns
{ job_id, status, image?: { url, width, height } }
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_expand_image",
"arguments": {
"image_url": "<image_url>"
}
}Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| image_urlrequired | string | — | Public URL of the source image. |
| direction | "left" | "right" | "up" | "down" | "all" | "all" | Expansion direction. |
| amount_pixels | number | 256 | Pixels to add per selected direction. |
| prompt | string | "" | Optional prompt to guide the new pixels. |
Examples
Expand to 16:9
json
{
"name": "studio_expand_image",
"arguments": {
"image_url": "https://cdn.wm.studio/uploads/portrait.jpg",
"direction": "all",
"amount_pixels": 384
}
}