Tongyi Wanxiang 3.0 is Alibaba's all-in-one video model. Its defining feature is the reference route: one request can carry images, videos, audio, a document, and a web page at once, and the prompt addresses each of them by number.
The fields that decide how you call it, and what each one means for your integration.
Three model IDs, one upstream model
wan3.0-text-to-video / wan3.0-image-to-video / wan3.0-reference-video
All three EvoLink IDs map to Alibaba's upstream wan3.0-video model. Upstream rejects mixing first/last frames with reference material, so pick the ID that matches your input.
Default resolution
720p
Upstream defaults to 1080p, which costs 4x the base rate. We default to 720p so a request with no quality field never lands on the most expensive tier by accident.
Duration
2-30 seconds, or -1 for auto
Auto duration lets the model choose the length. Because the length is unknown up front, credits are reserved at the 30s cap and the unused part is refunded on completion.
Reference material
Up to 10 images, 5 videos, 5 audio tracks, 1 document, 1 web page
The prompt addresses them as Image 1, Video 1, Audio 1 — each modality numbered independently, in array order. A document and a web page are mutually exclusive.
Audio track
On by default, switchable
The generate_audio boolean controls whether the generated video has sound. It costs the same either way. Note the field name: a top-level audio key is not part of the request schema and gets dropped, so it must be generate_audio.
Result links
Valid for about 24 hours
Result URLs point at upstream storage and are not re-hosted. Download or copy anything you need to keep before they expire.
modelstring
Choose the text, image, or reference-video EvoLink model ID that matches your input.
Default: route-specific
promptstring
Describe the scene, motion, camera behavior, audio, and how numbered reference assets should be used.
Default: required
qualityenum
Select 480p, 720p, or 1080p. Resolution changes the per-second billing multiplier.
Default: 720p
durationinteger
Set 2-30 output seconds, or -1 to let the model choose the duration.
Default: 5
aspect_ratioenum
Use adaptive, 16:9, 4:3, 1:1, 3:4, or 9:16 for the output frame.
Default: adaptive
generate_audioboolean
Turn the generated audio track on or off without changing the video rate.
Default: true
model_paramsobject
Pass first/last frames or numbered image, video, audio, document, and web-page references.
Default: route-specific
callback_urlstring
Receive an HTTPS completion notification instead of relying only on task polling.
Default: optional
The reference route is what sets Wan 3.0 apart — most of these depend on it.
Product commercials
Feed a product photo plus a reference video of the camera move you want, and get a finished spot that keeps the product consistent.
Character consistency
Supply several images of the same character so the model holds their look across an entire clip.
Style transfer
Use a reference video for motion and reference images for look, then describe the new scene in the prompt.
Brief to video
Attach a deck or PDF as a reference document and let the model work from the brief itself.
Frame interpolation
Give a first and last frame on the image-to-video route and let the model fill in the motion between them.
Long-form shots
Durations run to 30 seconds, long enough for a full scene rather than a three-second loop.
An honest read on where it fits and where something else is a better call.
Four things that trip people up on the first integration.
Reference numbering is positional
Images, videos, and audio are numbered independently and follow array order. Reordering an array changes what "Image 2" refers to in your prompt.
Input video counts towards billing
Reference video seconds are added to the output duration before the resolution multiplier. A 5s output with a 3s reference video bills as 8 seconds.
Two parameters were dropped
negative_prompt and prompt_extend exist on Wan 2.7 but not on Wan 3.0. Sending them returns 400 with the offending field named.
Transparent per-second pricing
Billed per second of video, with the rate scaling by resolution. Your exact per-second rate is on the pricing page.
One API key
The same key and endpoint as every other model on EvoLink — no separate Alibaba Cloud account or workspace setup.
One balance
Credits are shared across every model. Failed tasks are refunded in full, automatically.
Task tracking built in
Poll a single task endpoint or register a callback. Reserved and settled amounts are both visible in your logs.
Switch models without rewriting
Wan, Seedance, Kling, MiniMax and more share one request shape — changing model is changing a string.
Where to go once you have decided Wan 3.0 fits.
What is the Wan 3.0 API?
Wan 3.0 (Tongyi Wanxiang 3.0) is Alibaba's video generation model. EvoLink exposes three request model IDs — text-to-video, image-to-video, and reference-to-video — that map to the upstream wan3.0-video model on the standard /v1/videos/generations endpoint.
Why are there three model IDs instead of one?
Upstream refuses to mix first/last frames with reference material in the same request. Splitting that rule into three model IDs means an invalid combination cannot be expressed in the first place, and the error you get names the right alternative.
How much does Wan 3.0 cost?
Billing is per second and the live table above is the source of truth for your route. 480p is the base rate, 720p is 2x, and 1080p is 4x. Reference video seconds are added to the output duration.
What is the default resolution?
720p. Upstream defaults to 1080p, but that tier costs four times the base rate, so we default to 720p — a request with no quality field never lands on the most expensive tier by accident.
What does duration: -1 do?
It hands the length choice to the model. Because the output length is unknown when the task is created, credits are reserved at the 30-second cap. You are only charged for the seconds actually generated, and the difference is refunded when the task finishes.
How long do the result links last?
About 24 hours. Result URLs point directly at upstream storage and are not re-hosted, so download or copy anything you want to keep as part of your completion handler.
Are reference images billed?
No. Only video seconds are billed — the output duration plus any reference video seconds. Reference images, reference audio, documents, and web pages are all free.
What is the difference between generate_audio and audio_urls?
generate_audio is a boolean that turns the generated video's soundtrack on or off, and it costs the same either way. audio_urls is an array of reference audio files on the reference-to-video route, used as material the prompt can address as Audio 1, Audio 2. Note that a top-level audio key is not accepted — the switch must be sent as generate_audio.
How do I reference material in the prompt?
By number, per modality: Image 1..N, Video 1..N, Audio 1..N, each following the order of its own array. Reordering an array changes what a given number points at.
Can I cancel a running task?
No. Wan 3.0 tasks cannot be cancelled once created. If a task fails, the reserved credits are refunded in full automatically.
Does Wan 3.0 support negative prompts?
No. negative_prompt and prompt_extend exist on Wan 2.7 but were dropped in Wan 3.0. Sending them returns a 400 naming the unsupported field — use Wan 2.7 if you depend on them.
How long does generation take?
Minutes rather than seconds, depending on duration and resolution. Generation is asynchronous: poll the task endpoint or register an HTTPS callback to be notified on completion.