charactersstableimagereferencebatch
Casting
studio_castingFront portrait, side profile, and full-body shot from a single reference.
Overview
Casts a character from a single reference image. Produces a consistent front portrait, three-quarter view, side profile, and front full-body shot suitable for downstream image or video generation as a character lock.
Auth
oauth-jwt
Returns
{ job_id, status, shots?: { front, three_quarter, side, full_body } }
Web client
src/app/[locale]/dashboard/creative-studio/tools/casting/casting-tool-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_casting",
"arguments": {
"reference_image_url": "<reference_image_url>"
}
}Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| reference_image_urlrequired | string | — | Source character image. |
| character_name | string | "" | Optional label saved with the cast. |
| wardrobe | string | "" | Optional wardrobe description. |
Examples
Cast a character
json
{
"name": "studio_casting",
"arguments": {
"reference_image_url": "https://cdn.wm.studio/uploads/face.jpg",
"character_name": "Lead — Maya",
"wardrobe": "white linen shirt, dark indigo trousers"
}
}