Overview

Conditions on a reference image plus a free-form camera descriptor (e.g. low angle, dutch tilt, over-the-shoulder). WM Studio's prompt-engineer composes the final prompt downstream. image_url is required — if missing or unreachable, the response returns asset_url_required with the public upload link.

Auth

oauth-jwt

Returns

{ imageUrl, generationId, creditsCharged, creditsRemaining, lowCreditsWarning? } — or asset_url_required / upgrade_required on gate failure.

Web client

src/app/[locale]/dashboard/creative-studio/tools/camera-angles/camera-angles-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_camera_angles",
  "arguments": {
    "prompt": "<prompt>",
    "camera": "<camera>",
    "image_url": "<image_url>"
  }
}

Parameters

Name	Type	Default	Description
promptrequired	string	—	Text description of the desired shot.
camerarequired	string	—	Free-form camera descriptor (`low angle`, `dutch tilt`, `over-the-shoulder`, …).
image_urlrequired	string	—	Public URL of the source image. Fabricated URLs are rejected by HEAD preflight.
model	string	"fal-ai/flux/dev"	Provider/model id.
aspect_ratio	string	—	Target aspect ratio.

Examples

Low-angle hero shot

json

Copy

{
  "name": "studio_camera_angles",
  "arguments": {
    "prompt": "product hero shot, dramatic side light",
    "camera": "low angle",
    "image_url": "https://v3b.fal.media/files/.../product.jpg"
  }
}