Wan 3.0 Prime Reference to Video
alibaba/wan-3.0-prime/reference-to-videoGenerate video from text and reference media with Wan 3.0 Prime Reference to Video from fal through one Spiral API key. Wan 3.0 Prime Reference-to-Video combines reference images, videos, and audio into a unified video with fast generation and strong multimodal coherence. It runs in the background and returns video. Pay as you go, with no subscription.
Pricing
resolution: 480p $0.0884, 720p $0.182, 1080p (default) $0.364 per second. Billed on duration, default 5.
Limits
- Runs
- In the background
- Returns
- video
- Longest queue wait
- 1 hour
- Run deadline
- 30 minutes
- 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 | text | — | Text prompt directing how the reference media is used. Reference media can be addressed positionally, e.g. 'the subject in Image 1 walks past Video 1'. |
resolution | one of 480p, 720p, 1080p | 1080p | Output video resolution tier. |
aspect_ratio | one of adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive | Output aspect ratio, or adaptive selection. |
duration | number (whole) 2 to 30 | 5 | Output duration in seconds. Set to null for smart duration, which lets the model pick a length from the prompt and reference media. |
audio | true or false | true | Include generated audio. |
enable_prompt_expansion | true or false | true | Enable intelligent prompt rewriting. Disabling it can save roughly 20-60 seconds of latency but is likely to degrade generation quality. |
enable_thinking | true or false | false | Enable enhanced reasoning before generation. |
seed | number (whole) 0 to 2147483647 | — | |
reference_image_urls | URLs or files | — | Up to 10 reference image URLs. |
reference_video_urls | URLs or files | — | Up to 5 reference video URLs totaling at most 15 seconds. Each clip must be at least 16 fps. Input video duration is billed in addition to output duration. |
reference_audio_urls | URLs or files | — | Up to 5 reference audio URLs totaling at most 15 seconds. |
file_url | text | — | Document URL to base the video on. Requires enable_thinking=true. |
web_url | text | — | Public webpage URL to base the video on. Requires enable_thinking=true. Only pages that do not require login can be read. |
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": "alibaba/wan-3.0-prime/reference-to-video",
"input": {
"prompt": "<prompt>"
}
}'Frequently asked questions
How much does Wan 3.0 Prime Reference to Video cost?
`resolution`: 480p $0.0884, 720p $0.182, 1080p (default) $0.364 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 3.0 Prime Reference to Video through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "alibaba/wan-3.0-prime/reference-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 3.0 Prime Reference to Video?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use Wan 3.0 Prime Reference to Video?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.