charactersstableimagetext
Casting
studio_castingGenerate a character casting shot from a structured profile.
Overview
Renders a single character casting portrait from a structured profile. Accepts WM Studio's casting schema (genderIdentity, raceEthnicity, eyeColor, hairStyle, outfitStyle, cinematicGenre, characterArchetype, eraSetting, …). All profile keys are optional and unknown keys are sanitized away. No reference image required.
Auth
oauth-jwt
Returns
{ imageUrl, generationId, creditsCharged, creditsRemaining, lowCreditsWarning? }
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_casting",
"arguments": {
"character_name": "<character_name>",
"prompt": "<prompt>"
}
}Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| character_namerequired | string | — | Display name for the character (e.g. `Ada`). |
| promptrequired | string | — | Casting brief (e.g. `studio portrait, soft Rembrandt lighting, neutral grey backdrop`). |
| character_profile | object | — | Widemile casting schema keys: `characterType, genderIdentity, raceEthnicity, eyeColor, heightCm, weightKg, bodyType, hairStyle, hairTexture, hairColor, facialHair, outfitStyle, outfitDetails, cinematicGenre, characterArchetype, eraSetting`. |
| model | string | "vertex-ai/gemini-3-pro-image" | Provider/model id. Director MCP image generation is locked to Vertex-backed Nano Banana Pro. |
| aspect_ratio | string | — | Target aspect ratio. |
Examples
Cast a noir detective
json
{
"name": "studio_casting",
"arguments": {
"character_name": "Ada",
"prompt": "studio portrait, soft Rembrandt lighting, neutral grey backdrop",
"character_profile": {
"genderIdentity": "female",
"eyeColor": "hazel",
"hairStyle": "shoulder-length wavy",
"hairColor": "auburn",
"outfitStyle": "tailored beige trench coat",
"cinematicGenre": "noir",
"characterArchetype": "detective"
}
}
}