Wan 3.0 Basic Reference to Video API

Reference-driven Alibaba Wan 3.0 that reports failures immediately. Send model: wan-3-0-basic-refs to POST /api/v1/videos/generations with the same fields and price as wan-3-0-refs. If a generation fails, it is not retried: the task ends as failed and the tokens are refunded right away.
Get API Key
Guitar resting on a wooden chair in a sunlit room, with reference photos on the wall

Reference Video Generation With No Automatic Retry

Same reference inputs

Up to 10 ref_imgs, 5 ref_videos and 5 ref_audios, plus one ref_file or one ref_link. Cite them in the prompt in array order, for example "the character in 图1 sits on the chair in 图2, playing guitar".
Character figurine and a small chair model side by side under a desk lamp

One attempt, immediate outcome

wan-3-0-refs may retry a failed generation before reporting it. wan-3-0-basic-refs never does, so a failure reaches your poller or callback immediately with the tokens refunded.
Single domino standing upright at the end of a fallen row
At least one reference field is required. First and last frames are rejected; use wan-3-0-basic for those.

Wan 3.0 Basic Reference to Video Request Fields and Limits

model and prompt

model is wan-3-0-basic-refs. In prompt, refer to images as [Image 1] or 图1, videos as 视频1 and audio as 音频1, numbered by array order.

Media references

ref_imgs up to 10; ref_videos up to 5 and 15 seconds total; ref_audios up to 5 and 15 seconds total.

ref_file / ref_link

One document (docx, pptx, pdf, txt…) or one public web page URL. Not both.

duration

Integer 2 to 30 seconds (default 5). Reference video length plus duration must not exceed 30 seconds; this is enforced after the task starts, so an over-limit job fails and is refunded.

resolution and ratio

resolution (alias quality): 480p, 720p (default) or 1080p. ratio (alias aspect_ratio): adaptive (default), 16:9, 4:3, 1:1, 3:4, 9:16.

generate_audio, seed, callback

Audio is on by default and free. seed 0 to 2147483647. custom_callback_url receives each status change, retried up to 3 times.
Same rates as all Wan 3.0 endpoints, charged as per-second rate × duration.

Wan 3.0 Basic Reference to Video API Pricing

480p: 2.91 tokens ($0.0582) per second

A 30-second 480p clip costs 87.3 tokens ($1.746).

720p: 5.82 tokens ($0.1164) per second

Default. A 5-second 720p clip costs 29.1 tokens ($0.582).

1080p: 11.64 tokens ($0.2328) per second

A 5-second 1080p clip costs 58.2 tokens ($1.164).

References are free inputs

Images, reference videos, audio, documents and links do not change the price. A failed task is refunded immediately because it is never retried.

Integrate the Wan 3.0 Basic Reference to Video API

1

1. Create an API key

Get a key at /keys and send it as Authorization: Bearer <key>.
2

2. Validate before sending

Check the reference counts, keep ref_file and ref_link exclusive, and make sure reference video length plus duration is 30 seconds or less.
3

3. Submit and save img_uuid

POST to /api/v1/videos/generations with model: wan-3-0-basic-refs and store the returned img_uuid and cost.
4

4. Act on success or failure

Read GET /api/v1/jobs/detail or your callback. Download successes within 24 hours; on failure, resubmit or adjust according to your own policy.
Create an API Key
Reference-guided generation in systems that manage their own retries.

What Developers Build with Wan 3.0 Basic Reference to Video

Queue workers with retry budgets

Let your job queue decide how many attempts each reference video gets and when to give up.

User-facing editors

Return a clear failure quickly so users can swap a reference image or shorten a clip and try again.

Brand videos from a brief

Combine logo and product images with a ref_file brief to draft on-brand clips.

Multi-model fallback

Fail fast on one reference model and send the same assets to another model your stack supports.
Retries, references and limits.

Wan 3.0 Basic Reference to Video API FAQ

What is the difference from wan-3-0-refs?

Same model, parameters and price; wan-3-0-basic-refs does not retry failed generations automatically.

Can I add a first or last frame?

No, they are rejected here. Use wan-3-0-basic for text-to-video or first/last frame generation.

Is a prompt required?

Only model is required by the schema, but you must send at least one of ref_imgs, ref_videos, ref_audios, ref_file or ref_link.

What is the 30-second joint limit?

Total reference video length plus duration must be 30 seconds or less, for example a 15-second reference with up to 15 seconds of output.

How is it priced?

Per second of output: 480p is 2.91 tokens ($0.0582), 720p is 5.82 tokens ($0.1164) and 1080p is 11.64 tokens ($0.2328).

Start Building with the Wan 3.0 Basic Reference to Video API