imagestableimagereference
Camera Angles
studio_camera_anglesGenerate a shot from a reference image with an explicit cinematic camera descriptor.
Overview
Conditions on a reference image plus a free-form camera descriptor (e.g. `low angle`, `dutch tilt`, `over-the-shoulder`). Widemile'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
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_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 | "vertex-ai/gemini-3-pro-image" | Provider/model id. Director MCP uses Vertex-backed Nano Banana Pro for reference-guided images. |
| aspect_ratio | string | — | Target aspect ratio. |
Examples
Low-angle hero shot
json
{
"name": "studio_camera_angles",
"arguments": {
"prompt": "product hero shot, dramatic side light",
"camera": "low angle",
"image_url": "https://cdn.wm.studio/uploads/product.jpg"
}
}