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

falVideoAvailable now

Wan 2.5 Text to Video

fal-ai/wan-25-preview/text-to-video

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

Pricing

resolution: 480p $0.065, 720p $0.13, 1080p (default) $0.195 per second. Billed on duration, default 5.

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—

The text prompt for video generation. Supports Chinese and English, max 1500 characters.

audio_urlURL or file—

URL of the audio to use as the background music. Must be publicly accessible.

Limit handling: If the audio duration exceeds the duration value (5 or 10 seconds),

the audio is truncated to the first 5 or 10 seconds, and the rest is discarded. If

the audio is shorter than the video, the remaining part of the video will be silent.

For example, if the audio is 3 seconds long and the video duration is 5 seconds, the

first 3 seconds of the output video will have sound, and the last 2 seconds will be silent.

  • Format: WAV, MP3.
  • Duration: 3 to 30 s.
  • File size: Up to 15 MB.
aspect_ratioone of
16:9, 9:16, 1:1
16:9

The aspect ratio of the generated video

resolutionone of
480p, 720p, 1080p
1080p

Video resolution tier

durationone of
5, 10
5

Duration of the generated video in seconds. Choose between 5 or 10 seconds.

negative_prompttext—

Negative prompt to describe content to avoid. Max 500 characters.

enable_prompt_expansiontrue or falsetrue

Whether to enable prompt rewriting using LLM. Improves results for short prompts but increases processing time.

seednumber (whole)—

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

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/wan-25-preview/text-to-video",
    "input": {
      "prompt": "The white dragon warrior stands still, eyes full of determination and strength. The camera slowly moves closer or circles around the warrior, highlighting the…"
    }
  }'

Frequently asked questions

How much does Wan 2.5 Text to Video cost?

`resolution`: 480p $0.065, 720p $0.13, 1080p (default) $0.195 per second. Billed on `duration`, default 5. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Wan 2.5 Text to Video through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/wan-25-preview/text-to-video"` 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 Wan 2.5 Text to Video?

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

Can my AI agent use Wan 2.5 Text to Video?

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