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

src/app/[locale]/dashboard/creative-studio/tools/moodgrid/moodgrid-nine-panel-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.

MCPcurlTypeScript

Copy

{
  "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	"fal-ai/flux/dev"	Provider/model id.
aspect_ratio	string	—	Target aspect ratio.

Examples

Luxury marketing shot

json

Copy

{
  "name": "studio_brandshot",
  "arguments": {
    "prompt": "minimalist beige pedestal, soft window light, marble surface, shallow depth of field",
    "product_image_url": "https://v3b.fal.media/files/.../bottle.jpg",
    "brand_palette": ["#0A0A0A", "#F5F0E6", "#C79A52"],
    "aspect_ratio": "1:1"
  }
}