Wan 2.5 Text to Video
fal-ai/wan-25-preview/text-to-videoGenerate 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
| Field | Kind | Default | Description |
|---|---|---|---|
prompt required | text | — | The text prompt for video generation. Supports Chinese and English, max 1500 characters. |
audio_url | URL 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.
|
aspect_ratio | one of 16:9, 9:16, 1:1 | 16:9 | The aspect ratio of the generated video |
resolution | one of 480p, 720p, 1080p | 1080p | Video resolution tier |
duration | one of 5, 10 | 5 | Duration of the generated video in seconds. Choose between 5 or 10 seconds. |
negative_prompt | text | — | Negative prompt to describe content to avoid. Max 500 characters. |
enable_prompt_expansion | true or false | true | Whether to enable prompt rewriting using LLM. Improves results for short prompts but increases processing time. |
seed | number (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.