charactersbetaimagereference
UGC Room
studio_ugc_roomUGC-style room scene with product placement.
Overview
Generates a UGC-style room scene with a product placed naturally inside it. `product_image_url` is required — fabricated URLs are rejected by HEAD preflight. `room_style` is a free-form descriptor that Widemile's UGC compose-prompt route refines downstream.
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_ugc_room",
"arguments": {
"prompt": "<prompt>",
"product_image_url": "<product_image_url>"
}
}Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| promptrequired | string | — | Scene description. |
| product_image_urlrequired | string | — | Public URL of the product. Fabricated URLs rejected. |
| room_style | string | — | Free-form room descriptor (e.g. `minimalist bedroom`, `cluttered college dorm`). |
| model | string | "vertex-ai/gemini-3-pro-image" | Provider/model id. Director MCP uses Vertex-backed Nano Banana Pro for product-reference images. |
| aspect_ratio | string | — | Target aspect ratio. |
Examples
Headphones on a desk
json
{
"name": "studio_ugc_room",
"arguments": {
"prompt": "morning coffee, focused work vibes, soft city light through blinds",
"product_image_url": "https://cdn.wm.studio/uploads/headphones.png",
"room_style": "minimalist home office"
}
}