Wan 3.0 Basic API for Text and Image to Video

The same Alibaba Wan 3.0 model, parameters and price as wan-3-0, with one difference: no automatic retry. Send model: wan-3-0-basic to POST /api/v1/videos/generations; if a generation fails, the task fails right away and the tokens are refunded, so your own code decides what to do next.
Get API Key
Rooftop at night with a cat silhouette and neon city lights in the distance

Wan 3.0 With a Fast, Final Answer

Text, first frame, or both frames

Send only a prompt for text-to-video, add image_url for a first frame, and add image_end_url (together with image_url) for a last frame.
Two photographs on a light table connected by a curved line of light

No automatic retry

If a generation fails, wan-3-0 may retry it before reporting; wan-3-0-basic never does. The task ends as failed and the tokens are refunded, which suits pipelines that run their own retry or fallback logic.
Railway switch with a single clear signal light at dusk

Up to 30 seconds with sound

duration is any integer from 2 to 30 seconds. generate_audio is on by default and costs nothing extra; turn it off for a silent clip.
Long film strip unrolling across a table beside a pair of headphones
model and prompt are required. Reference materials are rejected; use wan-3-0-basic-refs for those.

Wan 3.0 Basic Request Fields and Limits

model and prompt (required)

model is wan-3-0-basic; prompt describes the video.

image_url and image_end_url

Optional first-frame and last-frame image URLs. image_end_url must be used together with image_url. Omit both for text-to-video.

duration

Any integer from 2 to 30 seconds, default 5. Smart (automatic) duration is not offered because the price must be known in advance.

resolution

480p, 720p or 1080p, default 720p so an omitted value never bills at the top tier. quality is accepted as an alias.

ratio

adaptive (default, follows the input media), 16:9, 4:3, 1:1, 3:4 or 9:16. There is no 21:9. aspect_ratio is accepted as an alias.

generate_audio, seed, callback

generate_audio defaults to true at no extra cost. seed: 0 to 2147483647. custom_callback_url: optional public HTTPS URL.
Identical to wan-3-0: per-second rate × duration, with no hidden extras.

Wan 3.0 Basic API Pricing

480p: 2.91 tokens ($0.0582) per second

A 10-second 480p clip costs 29.1 tokens ($0.582).

720p: 5.82 tokens ($0.1164) per second

Default resolution. 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).

Failed means refunded

Tokens are deducted when the task is accepted. Without automatic retry, a failed generation is reported and refunded right away.

Integrate the Wan 3.0 Basic API

1

1. Create an API key

Generate a key at /keys and keep it on your server; send it as Authorization: Bearer <key>.
2

2. Submit the job

POST {"model": "wan-3-0-basic", "prompt": "…", "resolution": "720p", "duration": 5} to /api/v1/videos/generations, adding frame URLs if needed. Save img_uuid.
3

3. Track the status

Poll GET /api/v1/jobs/detail or receive the callback. Status moves through pending and processing to success or failed.
4

4. Handle the outcome

On success, download json[].value within 24 hours. On failure, the tokens are already refunded, so retry, change the prompt, or fall back as your product requires.
Create an API Key
Workflows that need a predictable, immediate result for every job.

What Developers Build with Wan 3.0 Basic

Interactive apps with timeouts

Show users a quick failure message instead of a long wait while a job is retried in the background.

Custom retry and fallback logic

Route a failed job to a different prompt, resolution or model according to your own rules.

Batch rendering with clear accounting

Run large prompt batches where each task ends in exactly one success or one refunded failure.

Storyboard transitions

Animate between two approved frames with image_url and image_end_url for previsualization.
How it differs from wan-3-0, plus inputs and pricing.

Wan 3.0 Basic API FAQ

How is wan-3-0-basic different from wan-3-0?

Same model, parameters and price. The only difference is that wan-3-0-basic never retries a failed generation automatically.

Can I use reference images or videos?

No. This endpoint rejects reference materials; use wan-3-0-basic-refs for reference-driven generation.

What durations are supported?

Any whole number of seconds from 2 to 30, default 5.

Why is the default resolution 720p?

So an omitted value never bills at the most expensive 1080p tier. Set resolution: 1080p explicitly when you need it.

Does turning on audio cost more?

No, generate_audio is free and on by default.

What happens to my tokens if a job fails?

They are refunded automatically as soon as the task fails.

Start Building with the Wan 3.0 Basic API