imagestableimagereference
Brandshot
studio_brandshotBrand-consistent product/marketing shot from a single product reference.
Overview
Takes a product image and an optional brand color palette (hex strings) and renders a luxury-grade marketing composition. `product_image_url` is required — if missing or unreachable, the response returns `asset_url_required` with the upload link.
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_brandshot",
"arguments": {
"prompt": "<prompt>",
"product_image_url": "<product_image_url>"
}
}Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| promptrequired | string | — | Scene/composition description. |
| product_image_urlrequired | string | — | Public URL of the product reference. Fabricated URLs rejected. |
| brand_palette | string[] | — | Hex color strings (e.g. `["#0A0A0A", "#F5F0E6", "#C79A52"]`). |
| 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
Luxury marketing shot
json
{
"name": "studio_brandshot",
"arguments": {
"prompt": "minimalist beige pedestal, soft window light, marble surface, shallow depth of field",
"product_image_url": "https://cdn.wm.studio/uploads/bottle.jpg",
"brand_palette": ["#0A0A0A", "#F5F0E6", "#C79A52"],
"aspect_ratio": "1:1"
}
}