Wan v2.6 Reference-to-Video
Wan v2.6 Reference-to-Video is Alibaba Cloud's quality-first reference-to-video model, extracting identity from short clips and rendering new scenes with high-fidelity appearance, voice, and motion preservation at up to 1080p. Your use subject to Alibaba Cloud's Terms & Privacy Policies.
import { experimental_generateVideo as generateVideo } from 'ai';
const result = await generateVideo({ model: 'alibaba/wan-v2.6-r2v', prompt: 'A serene mountain lake at sunrise.'});Playground
Try out Wan v2.6 Reference-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.
Wan v2.6 Reference-to-Video
Your generated video will appear here.
Providers
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.
More models by Alibaba Cloud
| Model |
|---|
| 1M | 2.7s | 320tps | $0.32/M | $1.28/M | Read:$0.08/M Write:$0.5/M | — | +2 |   | 06/02/2026 | |||
| 991K | 2.6s | 48tps | $2.50/M | $7.50/M | Read:$0.5/M Write:$3.13/M | — | | 05/21/2026 | ||||
| 240K | 2.1s | 116tps | $1.30/M | $7.80/M | Read: $0.26/M Write: $1.63/M | — | | 04/20/2026 | ||||
| 1M | 1.5s | 110tps | $0.50/M | $3/M | Read: $0.1/M Write: $0.63/M | — | +1 | | 04/02/2026 | |||
| 1M | 1.5s | 306tps | $0.10/M | $0.40/M | Read:$0.0/M Write:$0.13/M | — | +1 | | 02/24/2026 | |||
| 262K | 0.7s | 51tps | $0.20/M | $0.88/M | Read:$0.11/M Write:— | — |  | 09/23/2025 |
About Wan v2.6 Reference-to-Video
Alibaba Cloud positioned Wan v2.6 Reference-to-Video as China's first reference-to-video generation model. The core idea is simple: feed the model a short video clip of a person, and it extracts enough about their face, body, clothing, voice, and movement style to convincingly place them into an entirely new scene described by text.
What sets the standard R2V apart within the Wan lineup is its emphasis on reconstruction depth. The model devotes additional inference time to faithfully reproducing fine-grained identity signals, the specific way light falls across facial features, subtle mannerisms in how a subject moves, the particular resonance of a voice. For final-delivery video where a client or audience will scrutinize whether the generated character truly matches the reference, this level of fidelity matters.
The reference pipeline accepts multiple characters from reference images or videos. On AI Gateway, pass reference URLs in order and name them character1, character2, and so on in the prompt (see the reference-to-video docs). You can mix images and videos within provider limits (up to five references total). Each video reference can be 2 to 30 seconds. Output duration is 2 to 10 seconds at 720p or 1080p, with five aspect ratio options covering landscape, portrait, square, and intermediate formats.
What To Consider When Choosing a Provider
- Configuration: Because R2V allocates more compute to identity reconstruction than the Flash variant, generation times are longer. Budget wall-clock time accordingly when planning render queues for final-delivery assets.
- Zero Data Retention: AI Gateway supports Zero Data Retention for this model via direct gateway requests (BYOK is not included). To configure this, check the documentation.
- Authentication: AI Gateway authenticates requests using an API key or OIDC token. You do not need to manage provider credentials directly.
When to Use Wan v2.6 Reference-to-Video
Best for
- Final-delivery marketing assets: Generated characters that must pass close visual inspection against the reference subject
- Brand campaign consistency: Voice and appearance preservation across a series of scenes rendered over time
- Virtual production pipelines: Directors who need confident identity transfer before approving a generated sequence
- Multi-subject compositions: Scenes where several reference identities appear together in one generated clip
Consider alternatives when
- Speed over peak fidelity: Wan-v2.6-r2v-flash provides faster turnaround during early creative exploration
- Photograph source material: Wan-v2.6-i2v animates from still images when the source is a photograph rather than a video clip
- Text-only video generation: Wan-v2.6-t2v is the appropriate model when no reference subject is involved
Conclusion
Wan v2.6 Reference-to-Video is purpose-built for cases where identity fidelity matters more than generation speed. It trades wall-clock time for meticulous reconstruction of appearance, voice, and motion from reference material, making it the right choice when the output needs to survive close comparison to the original subject.