Wan 3.0 Reference to Video API

Alibaba's Wan 3.0 guided by your own material. Send model: wan-3-0-refs to POST /api/v1/videos/generations with up to 10 images, 5 videos, 5 audio clips, and either a document or a web page. Clips run from 2 to 30 seconds at 480p, 720p or 1080p, with an audio track included at no extra cost.
Get API Key
Creative brief spread on a table with photos, a tablet and a printed document beside a camera

Five Kinds of Reference, One Request

Images, videos and audio by number

Up to 10 ref_imgs, 5 ref_videos and 5 ref_audios (videos and audio 15 seconds total each). The prompt refers to them as image 1, video 1, audio 1 (or 图1 / 视频1 / 音频1), numbered in array order.
Contact sheet of photos next to a film reel and a cassette on a desk

A document or a web page as the brief

Pass one ref_file (docx, pptx, pdf, txt and similar) or one ref_link to a public web page. The two are mutually exclusive, so send at most one of them per request.
Printed slide deck and a laptop showing a product page beside a storyboard

Up to 30 seconds, with one joint limit

duration is 2 to 30 seconds, but the total length of ref_videos plus duration must not exceed 30 seconds. A 15-second reference with duration: 18 fails after it starts and is refunded.
Hourglass on an editing desk next to a timeline of film frames
Only model is strictly required, but at least one reference field must be present. First and last frames are rejected here.

Wan 3.0 Reference to Video Request Fields and Limits

model and prompt

model is wan-3-0-refs. In the prompt, cite images as [Image 1], [Image 2] or 图1, 图2 in array order.

ref_imgs, ref_videos, ref_audios

Up to 10 images, up to 5 videos (15 seconds total) and up to 5 audio clips (15 seconds total).

ref_file or ref_link

Optional single document URL (docx, pptx, pdf, txt…) or single public web page URL; mutually exclusive.

duration and resolution

duration: integer 2 to 30 (default 5), and reference video length plus duration must stay within 30 seconds. resolution (alias quality): 480p, 720p (default) or 1080p.

ratio, audio and seed

ratio (alias aspect_ratio): adaptive (default), 16:9, 4:3, 1:1, 3:4 or 9:16. generate_audio defaults to true at no extra cost. seed: 0 to 2147483647 for more reproducible results.

custom_callback_url

Optional public HTTPS URL that receives the job-detail body on every status change, retried up to 3 times.
Per-second rate × duration is exactly what gets charged. Same rates as Wan 3.0.

Wan 3.0 Reference to Video API Pricing

480p: 2.91 tokens ($0.0582) per second

A 5-second 480p clip costs 14.55 tokens ($0.291).

720p: 5.82 tokens ($0.1164) per second

The default resolution. A 5-second 720p clip costs 29.1 tokens ($0.582).

1080p: 11.64 tokens ($0.2328) per second

A 10-second 1080p clip costs 116.4 tokens ($2.328). The longest 1080p clip, 30 seconds, costs 349.2 tokens ($6.984).

References and audio are not billed

The charge depends only on output resolution and duration. Failed jobs, including those over the 30-second joint limit, are refunded.

Integrate the Wan 3.0 Reference to Video API

1

1. Create an API key

Generate a key at /keys and send it as a Bearer token from your backend.
2

2. Assemble references

Host images, clips and audio at public URLs, and optionally a document or web page. Measure your reference videos so their total plus duration stays within 30 seconds.
3

3. Submit the job

POST {"model": "wan-3-0-refs", "prompt": "…", "ref_imgs": ["…"], "duration": 5} to /api/v1/videos/generations and store img_uuid.
4

4. Retrieve the video

Poll GET /api/v1/jobs/detail or wait for your callback, then download the result before its link expires 24 hours after completion.
Create an API Key
Longer reference-guided clips built from mixed source material.

What Developers Build with Wan 3.0 Reference to Video

Explainers from a document

Turn a product brief or slide deck passed as ref_file into a short video draft.

Web page to promo clip

Point ref_link at a landing page and add product images to produce a promotional clip.

Character scenes up to 30 seconds

Keep a character and props from reference images consistent through a single longer shot.

Restyled footage with sound

Combine a reference video for motion with reference audio for the soundtrack.
References, limits, retries and pricing.

Wan 3.0 Reference to Video API FAQ

Can I pass a first or last frame?

No. This endpoint rejects first and last frames; use wan-3-0 for text-to-video or first/last frame generation.

Which references are required?

At least one of ref_imgs, ref_videos, ref_audios, ref_file or ref_link. ref_file and ref_link cannot be combined.

Why did my request fail with a long reference video?

The total length of ref_videos plus duration must not exceed 30 seconds. This is checked after the task starts, so the task fails and tokens are refunded.

What is the default resolution?

720p, at 5.82 tokens ($0.1164) per second.

Is there a version without automatic retry?

Yes, wan-3-0-basic-refs has the same parameters and price but returns failures right away without retrying.

Does audio cost extra?

No. generate_audio is on by default and included in the per-second price.

Start Building with the Wan 3.0 Reference to Video API