Overview
Wan3.0 is Tongyi Wanxiang’s all-in-one video model. Unlike Wan2.7, which makes you switch between four model IDs (t2v / i2v / r2v / videoedit), Wan3.0 handles every mode through a single model ID — what you send as media decides what it does. Text-to-video, image-to-video, reference-to-video and video editing all share one request body.
Two variants, identical capabilities, different speed and price:
wan3.0-video first, then switch latency-sensitive production traffic to wan3.0-video-prime.What changed from Wan2.7
Key features
Four modes, one model
type in input.media[].Up to 30 seconds
Native audio
soun track by default, no driving audio required. Use reference_audio when you want a specific voice timbre.Three resolution tiers
Group setup
Wan3.0 shares theWan&HappyHorse group with Wan2.7 and HappyHorse — one key calls them all. Video is billed per second, so your key must satisfy two conditions to route successfully:
- Billing mode: choose “Pay-as-you-go priority” or “Pay-as-you-go” — per-second video cannot route on a per-call key
- Group: include
Wan&HappyHorse

Create a key: set billing mode to pay-as-you-go priority and select the Wan&HappyHorse group (0.14x) to call every Wan3.0 / Wan2.7 / HappyHorse video model (the screenshot shows the old group name Wan)
Pricing
wan3.0-video.How the rate is derived: 0.98x by default, as low as 0.817x with bonuses
The console shows theWan&HappyHorse group at a 0.14x multiplier, denominated in CNY. APIYI settles in USD at a fixed 1:7 exchange rate:
Table 1: APIYI pricing in detail (billed per second)
Table 2: Tier-by-tier against Alibaba’s official pricing
wan3.0-video currently carries an official limited-time 30% discount (applied to all users by default), and APIYI pricing follows the discounted rate. wan3.0-video-prime has no discount. APIYI pricing will be adjusted when the promotion ends.Table 3: Total cost for common durations
Stacking top-up bonuses
With a top-up bonus, credited balance scales by up to ~1.2x, pushing the effective rate lower:⚠️ Billing rules (different from other video models)
Pre-authorization and settlement
- Without a reference video: the requested
durationis charged up front and that is the final amount — no settlement entry. - With a reference video: at submit time the gateway does not yet know how long your input video is, so it pre-authorizes at the 30-second cap, then recalculates against the actual billed seconds and refunds the difference (a separate negative entry on your bill).
wan3.0-video, 30 seconds). Keep enough balance available; the refund lands within seconds of task completion.⚠️ Endpoint choice (most important)
APIYI exposes two paths, but only the DashScope passthrough endpoint works fully with Wan3.0:Async workflow
Create the task
POST /wan/api/v1/services/aigc/video-generation/video-synthesis with the X-DashScope-Async: enable header. Returns a task_id immediately.Poll for status
GET /v1/tasks/{task_id} (with Authorization), every 5–10 seconds (never below 3), until status becomes completed.Download the video
result_url from the response directly — without the Authorization header (it is a signed OSS link; sending auth returns 403). Valid for 24 hours.Task states
Complete Python client
Parameter reference
The request body uses the nested DashScope structure:{ model, input: { prompt, media[] }, parameters: {...} }.
input fields
media[] types and the mode they select
type and url. The url must be a publicly reachable https link (upload local files to OSS / a CDN first, and keep them reachable until the task finishes).
parameters fields
Choosing: Wan3.0 / Wan2.7 / HappyHorse
Best practices
Iterate at 480P, render the final cut at 1080P
Iterate at 480P, render the final cut at 1080P
Trim reference videos before uploading
Trim reference videos before uploading
Describe motion, not just the picture
Describe motion, not just the picture
Never poll faster than every 3 seconds
Never poll faster than every 3 seconds
Do not auto-retry the same prompt on failure
Do not auto-retry the same prompt on failure
FAQ
Why are the billed seconds longer than my output video?
Why are the billed seconds longer than my output video?
Why was a large amount charged at submit and then refunded?
Why was a large amount charged at submit and then refunded?
The task stays in_progress with progress stuck at 30%?
The task stays in_progress with progress stuck at 30%?
result_url returns 403 on download?
result_url returns 403 on download?
Authorization header — it is a signed OSS link. Links expire after 24 hours, so re-host promptly.Submit returned 200 but the task failed?
Submit returned 200 but the task failed?
Getting "no available channel for this model"?
Getting "no available channel for this model"?
Wan&HappyHorse.Related documentation
Video Generation API reference
Wan2.7 Video Generation
HappyHorse Video Generation
Model Pricing
help.aliyun.com/zh/model-studio/wan3-video-generation-guide, help.aliyun.com/zh/model-studio/wan3-video-generation-api-reference