Async text-to-video via FAL (Kling/Veo).
Async text-to-video via FAL (Kling/Veo). BYOK ONLY. Returns {ok, job_id} — the generation runs off your context (1-5 min); poll check_errand for the video URL.
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/kling-video/... (default) | veo3/fast | wan/v2.2/1080p |
duration | string | optional | seconds, e.g. '5' (model-dependent) |
aspect_ratio | string | optional | e.g. 16:9 (default) | 9:16 | 1:1 |
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_video", "arguments": {"prompt": "a lighthouse at dusk"}}}'curl -s https://wingmanprotocol.com/tools/gen_video \
-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_video from your browser.
X-Payment header, or get a free key at /pricing (500 calls/month, no card, no crypto).