Wan 3 API · REST · pay per second
Wan 3 API for Text, Image and Reference to Video
One REST endpoint for Wan 3.0, Wan 3.0 Prime and Wan 2.7: send a prompt, a first frame or reference images, clips and audio, and get an MP4 with sound back, up to 30 seconds. Pay per second with credits; failed renders refund automatically.
- Free credits to test
- No subscription
- Callbacks and idempotency
- Auto refund on failure
curl -X POST "https://api.wan3api.org/v1/videos/generations" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "wan-3",
"prompt": "A red fox runs through fresh snow at sunrise, slow motion, cinematic",
"duration": 5,
"resolution": "480P",
"aspect_ratio": "16:9"
}'Try it in the playground
Same models, same prices. Tune the settings here and copy the matching API request.
API request for these settings
curl -X POST "https://api.wan3api.org/v1/videos/generations" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "wan-3",
"prompt": "Describe the video you want",
"duration": 5,
"resolution": "480P",
"aspect_ratio": "16:9"
}'Made with Wan 3.0
Real renders from this site, with the exact prompt. Use one as a starting point.
“A red paper boat drifts down a rain-soaked city gutter at dusk, neon reflections ripple on the water, the camera follows low and close, soft rain and distant traffic”
Text · Wan 3.0 · 720P · 5s
Use this prompt“Handheld walk through a crowded night market in Taipei, steam rising from food stalls, a vendor flips skewers and smiles at the camera, sizzling grills and chatter”
Text · Wan 3.0 · 1080P · 5s
Use this prompt“A teenage skater carves down an empty sunset street, the camera tracks beside her at board height, wheels rumbling on asphalt, warm lens flare”
Text · Wan 3.0 · 720P · 5s
Use this prompt“Top-down macro of a barista pouring latte art, milk folding into a rosetta, slow motion, quiet café ambience and a spoon clinking”
Text · Wan 3.0 Prime · 720P · 5s
Use this prompt“Drone shot gliding low over a turquoise glacier lake at sunrise, mist drifting across the water, a slow rise reveals snow peaks, deep wind and ambient strings”
Text · Wan 3.0 · 480P · 10s
Use this prompt
Built for production
The parts you'd otherwise build yourself around a raw model endpoint.
Async tasks
Submit returns in about a second with a task id. Poll or take a callback; no open connections for minutes.
Callbacks
Pass callback_url and get the finished task POSTed to your server, with retries.
Safe retries
An Idempotency-Key header makes a retried request return the first task instead of rendering twice.
Automatic refunds
Blocked, timed-out or failed renders put the credits back without a support ticket.
Links that last
Outputs are copied to our storage, so video_url keeps working after provider links expire.
Keys and logs
Several named keys per account, instant revoke, and a log of every request with status and cost.
Wan 3.0, Prime or Wan 2.7?
Wan 3.0 for most videos, Prime for final renders, Wan 2.7 for the lowest 1080P rate.
| Wan 3.0 | Wan 3.0 Prime | Wan 2.7 | |
|---|---|---|---|
| Resolution | 480P, 720P, 1080P | 480P, 720P, 1080P | 720P, 1080P |
| Length | 2–30 s | 2–30 s | 2–15 s |
| Inputs | Text, frames, references | Text, frames, references | Text, first (and last) frame |
| Typical wait | 1–3 minutes | 1–3 minutes | 1–3 minutes |
| Price | From 3 credits/s | From 5 credits/s | From 6 credits/s |
Pay per second
300 credits for $9.99. Wan 3.0 at 480P is 3 credits a second; a 5-second clip is 15 credits.
Starter
$9.99
300 credits · one-time
- ≈ 100 s of Wan 3.0 at 480P
- ≈ 17 s of Wan 3.0 Prime at 1080P
- $0.50 per 5-second clip
Creator
Most popular$29.99
1000 credits · one-time
- ≈ 333 s of Wan 3.0 at 480P
- ≈ 58 s of Wan 3.0 Prime at 1080P
- $0.45 per 5-second clip
Studio
Save 16%$69.99
2500 credits · one-time
- ≈ 833 s of Wan 3.0 at 480P
- ≈ 147 s of Wan 3.0 Prime at 1080P
- $0.42 per 5-second clip
Wan 3.0
2–30 sAlibaba's current Wan model: 2–30 s at 480P to 1080P, with sound generated in the same pass. The default for most videos.
| Resolution | Per second | 5 s video |
|---|---|---|
| 480P | 3 credits | $0.50 |
| 720P | 6 credits | $1.00 |
| 1080P | 11 credits | $1.83 |
Reference video is billed per second like output. Reference images are free.
Wan 3.0 Prime
2–30 sAlibaba's premium tier of Wan 3.0, with the same inputs and limits. Use it for final renders.
| Resolution | Per second | 5 s video |
|---|---|---|
| 480P | 5 credits | $0.83 |
| 720P | 9 credits | $1.50 |
| 1080P | 17 credits | $2.83 |
Reference video is billed per second like output. Reference images are free.
Wan 2.7
2–15 sThe previous generation: 720P or 1080P, 2–15 s, from a prompt or a first frame. No reference mode.
| Resolution | Per second | 5 s video |
|---|---|---|
| 720P | 6 credits | $1.00 |
| 1080P | 9 credits | $1.50 |
Text and image modes only; no reference uploads.
One-time packs · credits never expire · back automatically if a render fails
API FAQ
Sign in, open API keys in the dashboard and create one. It takes under a minute and new accounts get free credits to try the API.
No. Wan 3 API is an independent service, not affiliated with or endorsed by Alibaba. It runs the Wan models through an API provider and adds keys, billing, callbacks and refunds on top. Wan and Wan 3.0 are trademarks of their owners.
The same as the web app: per second of output, from 3 credits a second (Wan 3.0, 480P). Credits come from one-time packs; the response to every request tells you exactly what it charged.
The task ends with status failed and the credits go back to your balance automatically. Requests rejected up front, such as a blocked prompt or an unreachable image, are never charged.
Usually one to three minutes, depending on model, length and resolution. Short 480P clips finish first.
Each key can make 60 requests a minute and an account can run 3 renders at once. Contact us if you need more.
Yes, videos you render are yours to use, within our terms and the law. Don't upload images of people without their consent.
Ship video generation this afternoon
Create a key, copy the cURL, and have your first MP4 in a few minutes.