Wan 3.0 API

All-in-one video generation up to 30 seconds with native audio, omni-modal references (images, video, audio, files, web links), and a fast Prime tier.

Alibaba CloudVideo GenerationReleased Aug 6, 2026SingaporeProprietary EndpointNew

About Wan 3.0

All-in-one video generation up to 30 seconds with native audio, omni-modal references (images, video, audio, files, web links), and a fast Prime tier.

Also known as Alibaba Cloud Wan 3.0

text to videoimage to videoreference to videoaudio synccharacter consistency

Wan 3.0 specs

Model ID
wan-3-0
Provider
Alibaba Cloud
Category
Video Generation
Released
Aug 6, 2026
Input
TextImageVideoAudio
Output
Video
Region
Singapore
Endpoints
POST/v1/videos/generations
Alternate model IDs
alibaba/wan-3.0wan-3.0wan3.0wan3.0-videowan3.0-video-prime

Wan 3.0 API pricing

Live pay-as-you-go rates from the EmpirioLabs catalog. You are billed only for what you use, with no monthly minimum.

Type
Spec
Rate
Standard 480P
per second
$0.07
Standard 720P
per second
$0.14
Standard 1080P
per second
$0.28
Prime 480P
per second
$0.136
Prime 720P
per second
$0.28
Prime 1080P
per second
$0.56
Compare on the full pricing page

How to call the Wan 3.0 API

Wan 3.0 runs through POST /v1/videos/generations. The request returns a job_id right away; poll GET /v1/jobs/{job_id} until the job completes and read the output URLs from the result. Get an API key from the EmpirioLabs dashboard.

cURL: submit the job
curl https://api.empiriolabs.ai/v1/videos/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-3-0",
    "prompt": "Describe what you want Wan 3.0 to generate."
  }'
cURL: poll for the result
curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
Python
import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/videos/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "wan-3-0",
        "prompt": "Describe what you want Wan 3.0 to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)
Full Wan 3.0 API reference

Wan 3.0 API parameters

Request parameters supported by the Wan 3.0 API on EmpirioLabs. Defaults apply when a field is omitted.

ParameterTypeDefaultRange / valuesDescription
promptstring--Scene description, up to 20,000 characters. In reference mode, address inputs in your prompt as Image 1, Video 1, Audio 1.
model_tierenumstandardstandard, primestandard: full quality at the base rate. prime: significantly faster end-to-end generation at a higher per-second rate. Each tier is billed at its own rate.
modeenumautoauto, t2v, i2v, r2vAuto detects from attachments. t2v: text-to-video. i2v: animate one image, or interpolate between two (first and last frame). r2v: omni reference from images,...
resolutionenum1080p480p, 720p, 1080pOutput resolution. Each resolution bills at its own per-second rate.
durationnumber52 to 30Clip length in seconds. Pass -1 via the API to let the model choose the length. With video references, input plus output stays within 30 seconds.
aspect_ratioenumadaptiveadaptive, 16:9, 9:16, 1:1, 4:3, 3:4adaptive recommends an aspect ratio from your inputs and prompt.
imagestring--Image URL. i2v uses one or two images (first and last frame); r2v accepts up to 10 references.
videostring--Reference video URL (r2v). Up to 5 clips, 15 seconds combined.
seednumber-0 to 2147483647Reproducibility seed.
audiobooleantrue-Generate the soundtrack with the video. Turning it off does not change the price.
watermarkbooleanfalse-Add a provenance watermark to the output.
prompt_extendbooleantrue-Let the service rewrite the prompt for better results.
linkstring--Public web page URL used as a reference (r2v). Provide either a link or a file_url, not both.
file_urlstring--Document URL used as a reference (r2v): PDF, Office, or text files up to 100 MB and 50 pages. Provide either a file_url or a link, not both.

Good to know

Generation can take several minutes on the standard tier; the prime tier is significantly faster end to end. Modes are auto-detected from attachments, or override with the mode parameter. The model_tier parameter picks standard or prime; each tier bills at its own per-second rate.

Modes

  • T2V: no attachments
  • I2V: 1 image (first frame), or exactly 2 images (first + last frame)
  • R2V (omni reference): up to 10 images, 5 videos (15s combined), and 5 audio clips (15s combined), plus 1 document file or 1 public web link; address them in your prompt as Image 1, Video 1, Audio 1
  • I2V frames and R2V references cannot be combined in one request

Inputs

  • Images: JPEG, PNG, BMP, or WEBP, 240 to 8,000 px per side, up to 20 MB
  • Videos: MP4 or MOV, 1-15s per clip, up to 100 MB
  • Audio: WAV or MP3, 1-15s per clip, up to 15 MB

Duration and billing

  • Clips run 2-30 seconds; pass duration: -1 to let the model choose the length
  • With video references, input plus output share the 30-second budget, and billed seconds cover input + output combined
  • Output is MP4 at 30 fps with native audio; audio: false disables sound without changing the price

Uploaded media preprocessing

  • Reference videos are normalized to provider-compatible MP4 when needed.

Wan 3.0 API: common questions

How much does the Wan 3.0 API cost?

On EmpirioLabs, Wan 3.0 is billed pay as you go: Standard 480P $0.07 per second; Standard 720P $0.14 per second; Standard 1080P $0.28 per second. The live rate card on this page always matches what the API charges.

Which endpoint does Wan 3.0 use?

Wan 3.0 is served through POST /v1/videos/generations on api.empiriolabs.ai with standard bearer-token authentication.

Can I try Wan 3.0 in the browser before integrating?

Yes. The EmpirioLabs playground runs Wan 3.0 in the browser with the same parameters the API exposes, so you can test prompts before writing code.

How do I get a Wan 3.0 API key?

Create an EmpirioLabs account, then generate a key under API Keys in the dashboard. Billing is pay-as-you-go credits, so you only pay for the requests you make.

Ready to use better endpoints?

Check out our pricing or reach out if you want your own model deployed on our stack.