Video generation

Routed across fal.ai (Kling) and Replicate (Wan). Video jobs run asynchronously on the provider side; the API polls and returns when the clip is ready, so expect calls to take 1–4 minutes. Billing is per clip-second of output.

Request

POST /v1/tools/video
{
  "prompt": "a paper boat sailing through a rainy neon city, cinematic",
  "duration_seconds": 5,
  "aspect_ratio": "16:9",
  "routing": { "sort": "price" }
}

duration_seconds (2–10) is advisory: each provider clamps it to the clip lengths it supports (e.g. Kling renders 5s or 10s), and the response reports the actual duration.

Result

{
  "result": {
    "videos": [{ "url": "https://…mp4" }],
    "duration_seconds": 5
  }
}