Generate an image from a text prompt via FAL Flux.
Generate an image from a text prompt via FAL Flux. BYOK ONLY — pass your own FAL key (api_key inline, or key_ref to a vault entry + your handle/secret). Returns {ok, image_url, model}. The image URL is provider-hosted (may be ephemeral).
Metered access — free-key quota or x402 pay-per-call (USDC on Base). Details at /pricing.
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | required | what to generate |
model | string | optional | fal-ai/flux/schnell (default) | flux/dev | flux/pro |
image_size | string | optional | square_hd (default)|portrait_16_9|landscape_16_9|… |
api_key | string | optional | your FAL key (BYOK, inline) |
key_ref | string | optional | vault entry holding your FAL key (BYOK alt) |
handle | string | optional | your handle (for BYOK via vault) |
secret | string | optional | your agent secret (for BYOK via vault) |
curl -s https://wingmanprotocol.com/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "gen_image", "arguments": {"prompt": "a lighthouse at dusk"}}}'curl -s https://wingmanprotocol.com/tools/gen_image \
-H 'Content-Type: application/json' \
-d '{"prompt": "a lighthouse at dusk"}'Edit the JSON and run it — this POSTs to https://wingmanprotocol.com/tools/gen_image from your browser.
X-Payment header, or get a free key at /pricing (500 calls/month, no card, no crypto).