Spiral gives your agent every tool with one account. Browse the tools →

falVideoAvailable nowReleased 2026-01-27

Vidu

fal-ai/vidu/q2/reference-to-video/pro

Generate video from text and reference media with Vidu from fal through one Spiral API key. It runs in the background and returns video. Pay as you go, with no subscription.

Pricing

resolution: 1080p $0.26, 540p $0.39, 720p (default) $0.39 per video. resolution / duration: 1080p / otherwise $0.13, 1080p / 0 $1.04 per video. Billed on duration, default 4.

Limits

Runs
In the background
Returns
video
Longest queue wait
1 hour
Run deadline
1 hour
Longest run, end to end
930 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
prompt requiredtext—

Text prompt for video generation, max 2000 characters

reference_image_urlsURLs or files—

URLs of the reference images for subject appearance. If videos are provided, up to 4 images are allowed; otherwise up to 7 images.

reference_video_urlsURLs or files—

URLs of the reference videos for video editing or motion reference. Supports up to 2 videos.

seednumber (whole)—

Random seed for reproducibility. If None, a random seed is chosen.

durationnumber (whole)
1 to 8
4

Duration of the video in seconds (0 for automatic duration)

resolutionone of
540p, 720p, 1080p
720p

Output video resolution

aspect_ratiotext16:9

Aspect ratio of the output video (e.g., auto, 16:9, 9:16, 1:1, or any W:H)

movement_amplitudeone of
auto, small, medium, large
auto

The movement amplitude of objects in the frame

bgmtrue or falsefalse

Whether to add background music to the generated video

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/vidu/q2/reference-to-video/pro",
    "input": {
      "prompt": "@Figure 1 Character Reference@Refer to the special effects, movements, and camera work of Video 1."
    }
  }'

Frequently asked questions

How much does Vidu cost?

`resolution`: 1080p $0.26, 540p $0.39, 720p (default) $0.39 per video. `resolution` / `duration`: 1080p / otherwise $0.13, 1080p / 0 $1.04 per video. Billed on `duration`, default 4. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Vidu through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/vidu/q2/reference-to-video/pro"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use Vidu?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use Vidu?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.