Wan v2.6 Text-to-Video
Wan v2.6 Text-to-Video is the production-grade text-to-video model in Alibaba Cloud's Wan series, generating cinematic clips up to 15 seconds with automatic multi-shot scene composition and native audio at resolutions up to 1080p. Your use is subject to Alibaba Cloud's Terms & Privacy Policies.
View API reference- Price
- $0.10, Per secondLowest available configuration
import { experimental_generateVideo as generateVideo } from 'ai';
const result = await generateVideo({ model: 'alibaba/wan-v2.6-t2v', prompt: 'A serene mountain lake at sunrise.'});Copy link to headingPlayground
Try out Wan v2.6 Text-to-Video by Alibaba Cloud. Usage is billed to your team at API rates. Free users (those who haven't made a payment) get $5 of credits every 30 days.
Your generated video will appear here.
Copy link to headingProviders
Route requests across multiple providers. Copy a provider slug to set your preference. Visit the docs for more info. Using a provider means you agree to their terms, listed under Legal.
| Provider |
|---|
Getting started
Generate videos with Wan v2.6 Text-to-Video using the experimental_generateVideo function from AI SDK 6 or later. AI Gateway handles routing and polls until the video is ready.
Install the AI SDK (pnpm add ai dotenv), create an API key from the API Keys page, and set it as AI_GATEWAY_API_KEY in your environment. Full setup is covered in the video generation quickstart.
import { experimental_generateVideo as generateVideo } from 'ai';import fs from 'node:fs';import 'dotenv/config';
async function main() { const result = await generateVideo({ model: 'alibaba/wan-v2.6-t2v', prompt: 'A chicken flying into the sunset in the style of 90s anime', });
// Save the generated video fs.writeFileSync('output.mp4', result.videos[0].uint8Array);
console.log('Video saved to output.mp4');}
main().catch(console.error);Top-level parameters
Drive the output with the top-level resolution and duration parameters. Wan uses resolution, not aspectRatio.
import { experimental_generateVideo as generateVideo } from 'ai';import fs from 'node:fs';import 'dotenv/config';
async function main() { const result = await generateVideo({ model: 'alibaba/wan-v2.6-t2v', prompt: 'A chicken flying into the sunset in the style of 90s anime', resolution: '1280x720', duration: 5, });
// Save the generated video fs.writeFileSync('output.mp4', result.videos[0].uint8Array);
console.log('Video saved to output.mp4');}
main().catch(console.error);| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Yes | Text description of the video to generate. Max 1500 characters. |
duration | number | No | Video length in seconds. 2-15 seconds. |
resolution | string | No | Resolution ('1280x720', '1920x1080'). |
aspectRatio | string | No | Aspect ratio ('16:9', '9:16', '1:1', '4:3', '3:4'). |
generateAudio | boolean | No | Generate synchronized audio with the video. |
Input limits
| Input | Formats | Sources | Max count | Max size | Limits |
|---|---|---|---|---|---|
| Text | — | — | — | — | Up to 1500 characters |
| Audio | wav, mp3 | url | — | 15 MB | 3-30s |
Provider options
Load the version-agnostic Wan options under providerOptions.alibaba. shotType (v2.6 only) and audioUrl (v2.5 only) are version-specific and documented in the table below.
import { experimental_generateVideo as generateVideo } from 'ai';import fs from 'node:fs';import 'dotenv/config';
async function main() { const result = await generateVideo({ model: 'alibaba/wan-v2.6-t2v', prompt: 'A chicken flying into the sunset in the style of 90s anime', resolution: '1280x720', duration: 5, providerOptions: { alibaba: { promptExtend: true, negativePrompt: 'blurry, low quality', watermark: false, pollIntervalMs: 5000, pollTimeoutMs: 600000, }, }, });
// Save the generated video fs.writeFileSync('output.mp4', result.videos[0].uint8Array);
console.log('Video saved to output.mp4');}
main().catch(console.error);Pass Wan-specific options under providerOptions.alibaba in your generateVideo call.
| Parameter | Type | Required | Description |
|---|---|---|---|
promptExtend | boolean | No | Enhance prompt for better quality. Defaults to true. |
negativePrompt | string | No | What to avoid in the video. Max 500 characters. |
audioUrl | string | No | URL to audio file for audio-video sync — see the Input limits table for supported formats, duration, and size. v2.5 only. |
shotType | 'single' | 'multi' | No | 'multi' enables multi-shot cinematic narrative. v2.6 only. |
watermark | boolean | No | Add watermark to the video. Defaults to false. |
pollIntervalMs | number | No | How often to check task status. Defaults to 5000. |
pollTimeoutMs | number | No | Maximum wait time. Defaults to 600000 (10 minutes). |
Copy link to headingAbout Wan v2.6 Text-to-Video
Part of Alibaba Cloud's Wan 2.6 update, this model is the production-grade text-to-video tier in that family. You provide a text prompt describing a scene, and the model returns a finished video clip, up to 15 seconds, at 720p or 1080p, in any of five aspect ratios covering landscape, portrait, square, and broadcast formats.
Intelligent multi-shot storytelling is the most distinct new capability. When a prompt describes a sequence of events spanning multiple locations or moments, the model introduces scene cuts and camera transitions on its own rather than forcing everything into a single continuous take. The visual identity of characters and objects stays consistent across these cuts, which means a product demo or short narrative can be generated as a cohesive piece rather than stitched together from separate clips in post-production.
On the rendering side, the 2.6 generation produces noticeably cleaner output than its predecessor. Frame-to-frame temporal consistency is improved, reducing the flicker artifacts that plagued earlier text-to-video models on detailed elements like text overlays, fine textures, and hair. Audio, ambient, effects, and music, continues to be generated in the same pass as the video, maintaining the integrated pipeline introduced in the 2.5 generation.
Copy link to headingWhat To Consider When Choosing a Provider
- Configuration: Running a few test prompts in the AI Gateway playground before full integration will help you calibrate resolution-based pricing and generation times across available providers.
- Zero Data Retention: Zero Data Retention is available for this model. It is offered on a per-provider and model basis. See the documentation for details.
- Authentication: AI Gateway authenticates requests using an API key or OIDC token. You do not need to manage provider credentials directly.
Copy link to headingWhen to Use Wan v2.6 Text-to-Video
Best for
- Production-quality short-form video: Advertising, social content, and product demos where visual polish matters
- Multi-scene narrative prompts: Automatic multi-shot composition removes the need for manual clip editing
- Broadcast and traditional media: Workflows using the 4:3 and 3:4 aspect ratios not available in the 2.5 preview
- 15-second 1080p targets: Any text-to-video task where this duration and resolution represent your quality ceiling
Consider alternatives when
- Animating an existing image: Wan-v2.6-i2v is designed for image-driven workflows rather than pure text-to-video
- Real-person reference consistency: Wan-v2.6-r2v handles reference-based synthesis when character identity must match a source video
- Tight budget at 480p: Wan-v2.5-t2v-preview supports the lower resolution tier when 480p output is acceptable
Copy link to headingConclusion
Wan v2.6 Text-to-Video is Alibaba Cloud's recommended model for production text-to-video work in the Wan 2.6 line. The combination of 15-second multi-shot output, five aspect ratios, improved temporal stability, and integrated audio makes it a full-featured option in that lineup for teams shipping video generation features.
Copy link to headingFrequently Asked Questions
What makes multi-shot storytelling different from generating multiple separate clips?
The model handles scene transitions internally, maintaining character and object consistency across cuts. This produces a single cohesive video rather than requiring you to generate and stitch together separate clips with potential visual discontinuities.
Which aspect ratios are new in the 2.6 release?
The 2.6 model adds 4:3 and 3:4 to the existing 16:9, 9:16, and 1:1 options, covering traditional broadcast and print-adjacent formats that the 2.5 preview did not support.
How does the temporal stability improvement affect output quality?
The 2.6 generation reduces frame-to-frame flicker on high-frequency visual details, text overlays, logos, hair, and fine textures render more cleanly than in the 2.5 preview, producing more professional-looking output.
Can I specify the number or timing of scene cuts in a multi-shot video?
The model determines scene structure automatically based on the prompt content. You influence the number of scenes through the narrative structure of your prompt rather than through an explicit parameter.
What duration options are available?
Clips can be generated at 5, 10, or 15 seconds. The 15-second option is the longest in the Wan 2.6 series.
Is 480p output available with this model?
No. Wan v2.6 Text-to-Video supports 720p and 1080p only. For 480p draft-quality work or cost savings, use the Wan v2.5 T2V Preview.