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.

0/5000

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.0Wan 3.0 PrimeWan 2.7
Resolution480P, 720P, 1080P480P, 720P, 1080P720P, 1080P
Length2–30 s2–30 s2–15 s
InputsText, frames, referencesText, frames, referencesText, first (and last) frame
Typical wait1–3 minutes1–3 minutes1–3 minutes
PriceFrom 3 credits/sFrom 5 credits/sFrom 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 s

Alibaba's current Wan model: 2–30 s at 480P to 1080P, with sound generated in the same pass. The default for most videos.

ResolutionPer second5 s video
480P3 credits$0.50
720P6 credits$1.00
1080P11 credits$1.83

Reference video is billed per second like output. Reference images are free.

Wan 3.0 Prime

2–30 s

Alibaba's premium tier of Wan 3.0, with the same inputs and limits. Use it for final renders.

ResolutionPer second5 s video
480P5 credits$0.83
720P9 credits$1.50
1080P17 credits$2.83

Reference video is billed per second like output. Reference images are free.

Wan 2.7

2–15 s

The previous generation: 720P or 1080P, 2–15 s, from a prompt or a first frame. No reference mode.

ResolutionPer second5 s video
720P6 credits$1.00
1080P9 credits$1.50

Text and image modes only; no reference uploads.

One-time packs · credits never expire · back automatically if a render fails

Full pricing

Full pricing in the docs

API FAQ

·

Ship video generation this afternoon

Create a key, copy the cURL, and have your first MP4 in a few minutes.