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 WM Studio's UGC compose-prompt route refines downstream.

Auth

oauth-jwt

Returns

{ imageUrl, generationId, creditsCharged, creditsRemaining, lowCreditsWarning? }

Web client

src/app/[locale]/dashboard/creative-studio/tools/ugc-room/ugc-room-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_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	"fal-ai/flux/dev"	Provider/model id.
aspect_ratio	string	—	Target aspect ratio.

Examples

Headphones on a desk

json

Copy

{
  "name": "studio_ugc_room",
  "arguments": {
    "prompt": "morning coffee, focused work vibes, soft city light through blinds",
    "product_image_url": "https://v3b.fal.media/files/.../headphones.png",
    "room_style": "minimalist home office"
  }
}