Wan 2.7 Reference to Video overview
Wan 2.7 Reference to Video specs
- Model ID
alibaba/wan2.7-r2v- Developer
- Alibaba Cloud
- Input
- Image
- Output
- Video
- Endpoint
POST https://api.aimlapi.com/v2/video/generations
What is Wan 2.7 Reference to Video API?
Wan 2.7 R2V, a reference-to-video model by Alibaba Cloud that generates videos using reference images or videos. It enables character, motion, and style transfer.
Wan 2.7 Reference to Video API Pricing
- Pricing on request
Where to Use Wan 2.7 Reference to Video
Use cases
Character-driven storytelling is a documented use case, where a reference subject can be kept visually consistent while being placed into new video scenes.
Multi-character interaction scenes are a documented use case, with the model supporting videos that feature one or more characters while preserving their appearance across scenes.
Content production and social video are documented use cases, including branded video content and campaigns that need a specific person or spokesperson to remain consistent.
Video dubbing and localization are also documented use cases, with the model used to generate dubbed or localized video while preserving the speaker’s characteristics.
Wan 2.7 Reference to Video API pricing
| Usage | Price | Unit |
|---|---|---|
| Video generation | $0.1 | per second |
The final price depends on request parameters such as resolution or duration.
Prices from the AI/ML API price list, checked on Nov 4, 2026.
Wan 2.7 Reference to Video vs other video models: prices
AI/ML API rates for 5 models, per second.
| Model | Per second |
|---|---|
| $0.1 | |
| $0.05 | |
| $0.1 | |
| $0.1 | |
| $0.14 |
How to use the Wan 2.7 Reference to Video API
Build with your agent
Give your agent the model details, code and documentation.
1Get your API key
Create API keyexport AIMLAPI_KEY="8f2b4c7d9a1e6b3f…"2Make your first request
curl 'https://api.aimlapi.com/v2/video/generations' \
-H "Authorization: Bearer $AIMLAPI_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "alibaba/wan2.7-r2v",
"prompt": "A slow dolly shot through a sunlit greenhouse full of ferns, light dust in the air, natural camera motion"
}'import os
import requests
headers = {
"Authorization": f"Bearer {os.environ['AIMLAPI_KEY']}",
"Content-Type": "application/json",
}
payload = {
"model": "alibaba/wan2.7-r2v",
"prompt": "A slow dolly shot through a sunlit greenhouse full of ferns, light dust in the air, natural camera motion"
}
response = requests.post("https://api.aimlapi.com/v2/video/generations", headers=headers, json=payload, timeout=120)
response.raise_for_status()
print(response.json())const response = await fetch("https://api.aimlapi.com/v2/video/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.AIMLAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"model": "alibaba/wan2.7-r2v",
"prompt": "A slow dolly shot through a sunlit greenhouse full of ferns, light dust in the air, natural camera motion"
}),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());The request returns a generation id. Poll GET https://api.aimlapi.com/v2/video/generations?generation_id=<id> until the status is completed.
Related articles
Wan 2.7 Reference to Video FAQ
What inputs and outputs does Wan 2.7 Reference to Video support?
Wan 2.7 Reference to Video takes image as input and returns video.
When was Wan 2.7 Reference to Video released?
Wan 2.7 Reference to Video became available on April 28, 2026.
How much does Wan 2.7 Reference to Video cost?
Wan 2.7 Reference to Video costs $0.1 per second on AI/ML API, billed as you go with no subscription.
How is Wan 2.7 Reference to Video billed?
Wan 2.7 Reference to Video costs $0.1 per second on AI/ML API, billed as you go with no subscription.
Can Wan 2.7 Reference to Video take an existing image as input?
Yes, Wan 2.7 Reference to Video accepts image input as well as a text prompt.
Who created Wan 2.7 Reference to Video?
Wan 2.7 Reference to Video was built by Alibaba Cloud.
How do I call Wan 2.7 Reference to Video on AI/ML API?
Use alibaba/wan2.7-r2v as the model id on AI/ML API.
Is Wan 2.7 Reference to Video available through a single API key?
Yes. Wan 2.7 Reference to Video is served through AI/ML API, so the same key and endpoint format used for other models applies.
What kinds of videos can I generate with Wan 2.7 Reference to Video?
It generates videos from reference images or videos, enabling character, motion, and style transfer.
Does Wan 2.7 Reference to Video keep characters consistent across scenes?
Yes, its reference-to-video feature is designed for character transfer, helping maintain consistency.

