WM StudioDocs
ToolsWorkflowsChangelogGitHub
  • Introduction
  • Getting started
  • Configuration
  • Tool index
  • Camera Anglesstudio_camera_angles
  • Expand Imagestudio_expand_image
  • Upscale Imagestudio_upscale_image
  • Storyboardstudio_storyboard
  • Brandshotstudio_brandshot
imagestableimagereferenceoutpaint

Expand Image

studio_expand_image

Outpaint 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 WM Studio Expand tool.

Auth
oauth-jwt
Returns
{ job_id, status, image?: { url, width, height } }
Web client
src/app/[locale]/dashboard/creative-studio/tools/expand-image/expand-image-client.tsx
MCP handler
mcp-director/src/tools/studio.py

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

NameTypeDefaultDescription
image_urlrequiredstring—Public URL of the source image.
direction"left" | "right" | "up" | "down" | "all""all"Expansion direction.
amount_pixelsnumber256Pixels to add per selected direction.
promptstring""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
  }
}

Related tools

studio_upscale_image
Increase resolution and detail on an existing image.
studio_generate_image
Text-to-image and image-to-image generation across the full WM Studio model catalogue.
← All toolsView handler
On this page
  • Overview
  • Quick start
  • Parameters
  • Examples
  • Related tools
WM Studio MCP — v2.0.0
Docs home