Wan 3.0 API

Alibaba Tongyi Wanxiang 3.0: 2–30 s video with audio, first/last frame, 480p–1080p.

Alibaba·VideoAvailable

from$0.03/ second~~$0.033~~10% off

Model IDwan-3.0

Try in Playground View API

text-to-videoimage-to-videoaudio

Input

Text · Image

Output

Video

Provider

7 providers

Duration (s)

2 – 30

Resolution

480p · 720p · 1080p

Aspect ratio

16:9 · 9:16 · 1:1 · 4:3 · 3:4

Last 7 days · not enough recent requests for stats yet.

Wan 3.0 pricing

Prices are per unit; requests without a provider are routed to the cheapest provider that supports your parameters.

Option	480p	720p	1080p
All options	$0.043 / second 5 Credits	$0.086 / second 9 Credits	$0.171 / second 18 Credits

Try Wan 3.0 before you integrate

Test output quality, compare provider prices and estimate cost before writing any code.

Provider

Video

Estimated cost

Input

Prompt*prompt

First frameimage_url

Last frameend_image_url

Duration (s)duration

Resolutionresolution

Aspect ratioaspect_ratio

Generate audiogenerate_audio

Seedseed

Result

Idle

Your generation will appear here.

Provider prices for this request

Enter a prompt to compare provider prices.

Wan 3.0 prompt examples

Ready-to-use prompts. Load one into the playground and tweak it.

Source

Scene

8 prompts

A lighthouse beam sweeps through heavy rain over black rocks at night, waves detonatin

A lighthouse beam sweeps through heavy rain over black rocks at night, waves detonating against the cliff.

A young female piano tuner works alone inside an empty concert rehearsal hall, careful

A young female piano tuner works alone inside an empty concert rehearsal hall, carefully adjusting the strings of a grand piano. A handsome young man enters from the opposite side carrying another tuning kit. They both stop when they realize they have been hired for the same piano. Without speaking, they sit on opposite sides and each plays a single note. She adjusts one string. He answers with another note. Their awkward disagreement slowly turns into an improvised musical conversation. The camera begins with a wide composition across the empty hall, glides toward the piano, then moves between their hands and subtle expressions. Romantic musical comedy, natural chemistry, elegant concert-hall acoustics, cinematic warm light.

A lone astronaut walks through the ruins of a once-busy city, surrounded by abandoned

A lone astronaut walks through the ruins of a once-busy city, surrounded by abandoned cars, overgrown skyscrapers, and trees growing through cracked streets. She discovers a small child standing inside an old convenience store, holding a glowing flower. The astronaut slowly removes her helmet as birds suddenly rise into the sky and sunlight breaks through the clouds. Emotional science-fiction film, grand post-apocalyptic environment, slow cinematic camera movement, wide establishing shots, intimate facial close-ups, realistic dust particles, warm sunlight contrasting with cold ruins, epic yet hopeful atmosphere.

The race car sped along the track

The race car sped along the track.

Piano tuners duet

Romance

Two strangers hired to tune the same grand piano start answering each other note by note until it becomes a duet. Camera moves from a wide shot of the empty hall to their hands, then to their smiling faces. Warm light, hall acoustics.

Lighthouse storm

Nature

A lighthouse beam sweeps through heavy rain as huge waves smash against the cliff at night, thunder rolling in the distance.

Wan 3.0 API reference

Endpoints, request fields and runnable examples for this model.

Base URL

https://01router.com/api/v1

llms.txt

Quick start

Set API_KEY to your project key, then run a sample from your server. Replace example media URLs with your own public URLs.

Auto-routing chooses a provider that supports the request. Select a provider to see its input constraints and pinned request examples.

curl https://01router.com/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "wan-3.0",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}
JSON

# Replace GENERATION_ID with the id returned above; poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/GENERATION_ID -H "Authorization: Bearer $API_KEY"

Endpoints

Only endpoints relevant to this model are listed. Paths below include /api/v1. Click an endpoint to read its usage.

POST

/api/v1/generations

Create a generation (charges credits) · API key required

GET

/api/v1/generations/{id}

Get a generation; polls the provider while running · API key required

POST

/api/v1/generations/{id}/cancel

Cancel a running generation (credits refunded) · API key required

POST

/api/v1/quote

Price a request on every provider (no charge, no key needed) · Public · no key

GET

/api/v1/models/wan-3.0

Get one model · Public · no key

Authentication

Send your API key as a Bearer token. Requests are billed to the key owner's credits.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Get an API key

Input

Send JSON with Content-Type: application/json. Model parameters belong inside input; model, provider and callback_url are top-level fields.

Request body

Name	Type	Required	Description
model	string	Yes	"wan-3.0"
provider	string	No	Pin a provider; omit to auto-route to the cheapest. One of: fal \| 01router \| wavespeed \| kie \| apimart \| atlascloud \| vercel
input	object	Yes	Model parameters, see the input fields below.
callback_url	string	No	Optional public HTTPS webhook URL. The final task result is signed and delivered here; polling remains available.

input · input fields

Required fields are marked explicitly. Other fields use the listed defaults when omitted.

Name	Type	Required	Values	Default
prompt*	string	Yes	—	—
image_url Optional start image (image-to-video)	string	No	—	—
end_image_url	string	No	—	—
duration	integer	No	min: 2 · max: 30	5
resolution	string	No	480p \| 720p \| 1080p	720p
aspect_ratio	string	No	16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4	16:9
generate_audio	boolean	No	—	true
seed	integer	No	min: 0 · max: 2147483647	—

Callbacks →

Output

Creating a task does not mean generation has finished. Keep its id, poll until succeeded or failed, then read outputs or error. Amounts below are illustrative; actual charges depend on the request.

queued→processing→succeeded / failed

Task submitted

{
  "id": "gen_example",
  "object": "generation",
  "model": "wan-3.0",
  "type": "video",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

Task completed

{
  "id": "gen_example",
  "object": "generation",
  "model": "wan-3.0",
  "type": "video",
  "provider": "fal",
  "status": "succeeded",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "outputs": [
    "https://example.com/output.mp4"
  ],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": "2026-10-25T08:01:00.000Z"
}

Response fields

Name	Type	Required	Description
id	string	Yes	Generation ID. Use it to query or cancel this task.
object	string	Yes	generation
model	string	Yes	wan-3.0
type	string	Yes	video
provider	string	Yes	Provider
status	string	Yes	queued → processing → succeeded / failed. Stop polling at either terminal state.
input	object	Yes	Model parameters, see the input fields below.
outputs	string[]	Yes	Result URLs. Empty while processing; read after succeeded and save the files promptly.
error	string \| null	Yes	Failure reason, or null when no failure is reported.
credits	number	Yes	Credits charged for this request.
price_usd	number	Yes	Request price in USD.
created_at	string	Yes	Creation time in ISO 8601 format.
completed_at	string \| null	Yes	Completion time in ISO 8601 format; null before completion.

Get the result

Poll every few seconds until status is succeeded or failed. Output URLs are provider-hosted and may expire — download them promptly. Or pass callback_url to get the result pushed.

curl "https://01router.com/api/v1/generations/GENERATION_ID" \
  -H "Authorization: Bearer $API_KEY"

queued → processing → succeeded / failed. Stop polling at either terminal state. Result URLs. Empty while processing; read after succeeded and save the files promptly.

Cancel a task

Cancellation depends on provider support and task state. A confirmed cancellation returns status: failed and error: Canceled by user. Unsupported or completed tasks return 409 not_cancelable.

curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

Quote

Same body as creating a generation. Returns every available provider sorted by price, plus the ones that cannot serve the request and why.

curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "wan-3.0",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}
JSON

Model schema

This public endpoint returns the model parameters and each provider’s supported constraints and prices.

curl "https://01router.com/api/v1/models/wan-3.0"

Errors

Check the HTTP status and error.message. Fix the request before retrying validation or authentication errors. A failed generation is reported in status and error on the task itself.

{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}

400Invalid body or parameter value

401Missing or invalid API key

402Not enough credits

404Unknown model or generation

409The task cannot be canceled (already finished, or the provider does not support canceling)

429Too many requests — retry after the given seconds

502Every provider rejected the task (credits refunded)

Auth, routing, billing and error codes are covered in →

Use with AI

Give your coding assistant this model reference: endpoints, input constraints, output fields and request examples in plain text.

Open llms.txt

How does Wan 3.0 compare?

Specs and starting prices side by side. Test with the same prompt before you choose.

	Wan 3.0	HappyHorse 1.1	Wan 2.7	Grok Imagine Video 1.5
Vendor	Alibaba	Alibaba	Alibaba	xAI
Starting price	$0.03 / second	$0.063 / second	$0.06 / second	$0.011 / second
Input	Text · Image	Text · Image	Text · Image	Text · Image
Provider	7 providers	6 providers	7 providers	10 providers
Duration (s)	2 – 30	3 – 15	2 – 15	1 – 15
Resolution	480p · 720p · 1080p	480p · 720p · 1080p	720p · 1080p	480p · 720p · 1080p
Aspect ratio	16:9 · 9:16 · 1:1 · 4:3 · 3:4	16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9	16:9 · 9:16 · 1:1 · 4:3 · 3:4	16:9 · 4:3 · 3:2 · 1:1 · 2:3 · 3:4 · 9:16

Wan 3.0 API FAQ

What can Wan 3.0 do?

Alibaba's Wan 3.0 generates videos up to 30 seconds from text or from first/last frames, with native audio and strong scene storytelling.

What durations and resolutions are supported?

2 to 30 seconds at 480p, 720p or 1080p, with 16:9, 9:16, 1:1, 4:3 or 3:4.

Can I turn audio off?

Yes, set generate_audio to false. Turning it off does not reduce the price.

How long do generations take?

Long, high-resolution clips can take several minutes. Requests are asynchronous; poll the generation until it succeeds.

How is it billed on 01router?

Per output second at the chosen resolution; see the pricing table. Failed generations are refunded.

Related models

Other models you can call with the same API key.

Video · Alibaba

HappyHorse 1.1

Alibaba HappyHorse 1.1: strong character consistency and natural motion, 3–15 s.

from $0.063 / secondView API

Video · Alibaba

Wan 2.7

Wan 2.7: reliable Tongyi Wanxiang video with first/last-frame control, 2–15 s, 720p/1080p.

from $0.06 / secondView API

Video · xAI

Grok Imagine Video 1.5

Grok Imagine Video 1.5: 1–15 second videos with synchronized audio, at 480p, 720p or 1080p. Image-to-video follows the source image aspect ratio.

from $0.011 / secondView API

Video · ByteDance

Seedance 2.5

ByteDance’s flagship video model: up to 30 s in one pass, native synchronized audio, first/last-frame control.

from $0.086 / secondView API

Video · xAI

Grok Imagine Video 1.5 Lite

Grok Imagine Video 1.5 Lite: 1–15 second videos with synchronized audio, at 480p, 720p or 1080p. Image-to-video follows the source image aspect ratio.

from $0.013 / secondView API

Video · MiniMax

MiniMax H3 Max

MiniMax H3 post-trained by fal for speed: 5–15 s clips with first/last frame, ranked #1 on video arenas.

from $0.029 / secondView API