AI Video APIA genuinely unified public contract
Applications switch among text, frame control, references, documents, and web context with the same input fields on standard or Prime, while retaining one task endpoint, callback format, and billing account.
All-in-One multimodal video API
Wan 3.0 API
One Wan 3.0 Video API for text, frames, rich media, files, and web pages.
Wan 3.0 and Prime share one set of parameters for text-to-video, first/last-frame animation, multimodal references, documents, and public web pages. Choose a fixed or automatic duration through one asynchronous endpoint, with pre-charging, final settlement, callbacks, and a consistent task response.
Read the official model and pricing documentation2–30s or automatic
Output duration
480p / 720p / 1080p
Resolution
Image + video + audio + file + web
Reference inputs
Alibaba
wan-3.0-videoasync task
2–30s or automatic
Output duration
480p / 720p / 1080p
Resolution
Image + video + audio + file + web
Reference inputs
Model capabilities
Built for production API workflows, not one-off demos.
Use Wan 3.0 from the same platform surface as the rest of your video and image stack: API keys, credits, logs, webhooks, and docs stay consistent across providers.
Standard and Prime with the same parameters
Choose wan-3.0-video or wan-3.0-video-prime for text, a strict first frame, first and last frames, or multimodal references. Both use identical parameters; Prime costs 50% more per billable second.
Ordered multimodal references
Attach up to 10 images, five videos, and five audio files. Wan 3.0 preserves each media array's order so prompts can refer to Image 1, Video 1, or Audio 1 while combining visual identity, motion, and sound intent.
File and public web understanding
Use a supported public document URL or a login-free web page as source material. The model can interpret the content and turn it into a video brief without first converting every page into image references.
Up to 30 seconds with audio
Choose an integer duration from 2 to 30 seconds, or -1 for automatic duration. Audio is enabled by default. Reference-video input plus output duration must remain within the 30-second total limit.
Billing-safe asynchronous workflow
The API probes reference media before charging. Fixed durations bill requested output plus input video. Automatic duration pre-charges 30 total billable seconds and refunds only the unused difference after success. Successful tasks never receive failure refunds.
API workflow
Submit tasks, track progress, and return generated assets.
01
Choose text, frames, or references
Write a prompt up to 20,000 characters or provide public HTTP(S) media. Frame mode stays separate from reference media, files, and web links, while file_url and link_url remain mutually exclusive.
02
Select duration, ratio, and resolution
Choose 2–30 seconds or automatic duration (-1), adaptive or a supported fixed ratio, and 480p, 720p, or 1080p. Both standard and Prime accept the same input parameters.
03
Submit the task
Submit the generation request directly. The platform detects reference-video duration before charging and applies the selected resolution rate.
04
Poll or receive callbacks
Track the task through GET /v1/tasks/{taskId} or a callback URL. Wan 3.0 tasks run to a completed or failed terminal state and do not expose task cancellation.
POST /v1/videos/generations
curl -X POST https://api.aivideoapi.ai/v1/videos/generations -H "Authorization: Bearer sk-your-api-key" -H "Content-Type: application/json" -d '{
"model": "wan-3.0-video",
"callback_url": "https://your-server.com/webhook",
"input": {
"prompt": "Video 1 provides the camera move, Image 1 provides the product identity, and Audio 1 guides the soundtrack",
"image_urls": ["https://example.com/product.png"],
"video_urls": ["https://example.com/camera.mp4"],
"audio_urls": ["https://example.com/music.mp3"],
"resolution": "720p",
"aspect_ratio": "adaptive",
"duration": 5,
"audio": true
}
}'What teams build
Text-to-video campaigns
First and last frame transitions
Character and product reference videos
Motion and camera reference transfer
Audio-guided storytelling
Document-to-video explainers
Public article summaries
Longer 30-second creative sequences
Why choose Wan 3.0
The Wan 3.0 API benefits that matter to developers.
Exact reference-video billing
Server-side duration detection runs during generation submission. A 4.5-second reference plus five seconds of 720p output produces a 228-credit charge.
Explicit operational boundaries
The public contract accepts only public HTTP(S) URLs, enforces individual and combined media limits, and documents temporary 24-hour provider links so production systems know when to download or enable storage mirroring.
Frequently asked questions
Answers about the Wan 3.0 API.
What is the Wan 3.0 API?
Use POST /v1/videos/generations with model wan-3.0-video or wan-3.0-video-prime for text, first/last frames, multimodal references, documents, or public web pages, then receive an asynchronous task ID. Both versions accept the same parameters.
Which resolutions does the Wan 3.0 Video API support?
The documented tiers are 480p, 720p, and 1080p. The default is 1080p. This integration does not claim native 4K support because Alibaba's current Wan 3.0 API documentation lists only those three resolution tiers.
How much does Wan 3.0 cost?
Standard rates at 480p/720p/1080p are 12/24/48 credits per second; Prime rates are 18/36/72. Fixed-duration reference requests bill input plus output seconds. Automatic duration pre-charges 30 total seconds, including input, and refunds the unused difference after success. If actual duration cannot be verified, the successful task retains its pre-charge for manual review.
What are the Wan 3.0 media limits?
A request supports up to 10 reference images, five reference videos, and five reference audio files. Each video or audio item must be 1–15 seconds and each category can total at most 15 seconds. Input video plus output video cannot exceed 30 seconds.
Can I mix first/last frames with reference media?
No. First/last-frame mode is mutually exclusive with reference images, videos, audio, file_url, and link_url. A last frame also requires a first frame, and file_url cannot be combined with link_url.
How long is the Wan 3.0 result URL available?
Alibaba's upstream result link is available for about 24 hours. Accounts with Bailian R2 mirroring enabled receive a stored copy; otherwise download the result promptly after the task completes.
Pricing and usage
Clear model options with shared credits.
480p
12 credits/s
60 credits for 5 seconds without input video
720p
24 credits/s
120 credits for 5 seconds without input video
1080p
48 credits/s
240 credits for 5 seconds; default tier
Prime 480p / 720p / 1080p
18 / 36 / 72 credits/s
Same parameters; 50% more per billable second
Automatic duration
Pre-charge 30 total seconds
Includes input video; unused difference refunded after success
Reference video
Input + output seconds
Both use the selected resolution rate
Start building with Wan 3.0 in AI Video API.
Create one API key, use one credit balance, and switch between video and image models without provider-specific plumbing.