Wan v2.7 Reference-to-Video
import { experimental_generateVideo as generateVideo } from 'ai';
const result = await generateVideo({ model: 'alibaba/wan-v2.7-r2v', prompt: 'A serene mountain lake at sunrise.'});Copy link to headingPlayground
Try out Wan v2.7 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.7 Reference-to-Video
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.
Copy link to headingMore models by Alibaba Cloud
| Model |
|---|
| 1M | 3.9s | 55tps | $2/M | $6/M | Read:$0.25/M Write:$2.5/M | — | +1 | | 08/02/2026 | ||||
| 991K | 2.4s | 141tps | $0.03/M+2 more | $0.13/M+2 more | Read: $0.01/M+2 more Write: $0.04/M+2 more | — | +2 | | 07/28/2026 | ||||
| 1M | 2.1s | 278tps | $0.40/M+1 more | $1.60/M+1 more | Read: $0.08/M+1 more Write: $0.5/M+1 more | — | +2 |  | 06/02/2026 | ||||
| 991K | 2.0s | 61tps | $2.50/M | $7.50/M | Read:$0.5/M Write:$3.13/M | — | | 05/21/2026 | |||||
| 1M | 1.4s | 170tps | $0.10/M | $0.40/M | Read:$0.0/M Write:$0.13/M | — | +1 | | 02/24/2026 | ||||
| 262K | 1.0s | 53tps | $0.20/M | $0.88/M | Read:$0.11/M Write:— | — |  | 09/23/2025 |
Copy link to headingAbout Wan v2.7 Reference-to-Video
Wan v2.7 Reference-to-Video is the reference-to-video member of Alibaba Cloud's Wan 2.7 release. You supply reference images, reference videos, or both, and Wan v2.7 Reference-to-Video places the referenced subjects into an entirely new scene described by an optional text prompt. Up to three reference videos can be attached to a single generation.
Combined subject and voice referencing is the notable addition in the 2.7 generation. Wan v2.7 Reference-to-Video lets you bind a subject's visual identity and vocal identity together from your reference material, keeping both consistent in the generated output. The reference pipeline also supports multi-subject work, so several referenced identities can interact in one scene, and multi-shot workflows keep those identities stable across scene cuts.
Output runs 2 to 10 seconds, with a default of 5 seconds, at 720p or 1080p. Five aspect ratio options cover landscape, portrait, square, and intermediate formats: 16:9, 9:16, 1:1, 4:3, and 3:4. The 2.7 generation also brings smoother, more coherent motion than the 2.6 line, which helps generated subjects hold up under close comparison to their references.
Copy link to headingWhat To Consider When Choosing a Provider
- Configuration: Reference quality drives output quality. Clear, well-lit reference material gives the extraction pipeline more identity signal to work with, so curate your references before scaling up a render queue.
- Configuration: Pricing is per second of generated video and varies by resolution, so a 1080p clip costs more than the same clip at 720p. Run a few test prompts in the AI Gateway playground to calibrate cost and generation time before full integration.
- 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.
Copy link to headingWhen to Use Wan v2.7 Reference-to-Video
Best for
- Character-Driven Video Series: Subjects that must look and sound consistent across many generated scenes
- Brand and Spokesperson Content: Referenced people or mascots placed into new settings without a reshoot
- Multi-Subject Compositions: Scenes where several referenced identities interact in a single generated clip
- Multi-Shot Identity Stability: Sequences that keep referenced subjects consistent across automatic scene cuts
Consider alternatives when
- Text-Only Generation: Wan-v2.7-t2v handles pure text-to-video when no reference subject is involved
- Clips Beyond 10 Seconds: Wan-v2.7-t2v extends output duration to 15 seconds
- Previous-Generation Pipelines: Wan-v2.6-r2v remains available for workflows already tuned to the earlier release
Copy link to headingConclusion
Wan v2.7 Reference-to-Video is the model to reach for when generated video must stay faithful to a real subject. Combined subject and voice referencing, multi-subject support, and smoother motion than the 2.6 line make Wan v2.7 Reference-to-Video a strong default for identity-sensitive video work on AI Gateway.