Wan 2.7 R2V API
Reference-to-video — anchor up to 5 images and/or videos to drive a new shot.
Integrate Wan 2.7 R2V with a single API call — one key, one unified endpoint, and shared billing across every model on Apiframe.
model: "wan-2.7-r2v" What's special about Wan 2.7 R2V
- Outputs at 720p / 1080p.
- 5 aspect ratios, including 16:9, 9:16, 1:1.
- Generates clips from 2s to 10s.
- Image-to-video and reference-image support.
- Fast turnaround — about 180s per generation on average.
- Pay-as-you-go pricing with no Alibaba account required — you only pay for successful generations.
- One API key, unified billing, idempotency and webhooks across every Apiframe model.
Made with Wan 2.7 R2V
A few outputs generated through the Wan 2.7 R2V API on Apiframe.
Drone shot flying over a tropical coastline at sunrise, smooth cinematic motion
A vintage car driving through a rainy neon city at night, reflections on the asphalt
Time-lapse of clouds rolling over a mountain range in warm golden light
Overview
- Endpoint
- POST /v2/videos/generate
- Model ID
- wan-2.7-r2v
- Params key
- wan27R2vParams
- Modality
- video
- Provider
- Alibaba
- Pricing
- Pay-as-you-go
- Avg. completion
- ~180s
Capabilities
Quick start
Send a single POST /v2/videos/generate request with your API key to
generate with Wan 2.7 R2V. The call returns a jobId you can poll or
receive via webhook.
curl -X POST https://api.apiframe.ai/v2/videos/generate \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
"model": "wan-2.7-r2v",
"wan27R2vParams": {
"reference_images": [
"https://example.com/input.jpg"
],
"reference_videos": [
"https://example.com/input.jpg"
],
"resolution": "720p",
"shot_type": "single"
}
}'import requests
response = requests.post(
"https://api.apiframe.ai/v2/videos/generate",
headers={
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
json={
"prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
"model": "wan-2.7-r2v",
"wan27R2vParams": {
"reference_images": [
"https://example.com/input.jpg"
],
"reference_videos": [
"https://example.com/input.jpg"
],
"resolution": "720p",
"shot_type": "single"
}
},
)
print(response.json()) # { "jobId": "...", "status": "QUEUED" }const response = await fetch("https://api.apiframe.ai/v2/videos/generate", {
method: "POST",
headers: {
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
"model": "wan-2.7-r2v",
"wan27R2vParams": {
"reference_images": [
"https://example.com/input.jpg"
],
"reference_videos": [
"https://example.com/input.jpg"
],
"resolution": "720p",
"shot_type": "single"
}
}),
});
const { jobId } = await response.json();
console.log(jobId);Response & job lifecycle
Generation is asynchronous. A successful submission returns 202 Accepted
with a jobId. Poll GET /v2/jobs/{id} (or supply a
webhook_url) until the status is COMPLETED; the
result field then holds the output URL(s).
1. Submission response (202)
{
"jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
"status": "QUEUED"
}2. Poll for the result
curl https://api.apiframe.ai/v2/jobs/JOB_ID \
-H "X-API-Key: afk_your_api_key_here"import requests, time
while True:
job = requests.get(
"https://api.apiframe.ai/v2/jobs/JOB_ID",
headers={"X-API-Key": "afk_your_api_key_here"},
).json()
if job["status"] in ("COMPLETED", "FAILED"):
break
time.sleep(2)
print(job["result"])let job;
do {
await new Promise((r) => setTimeout(r, 2000));
job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
headers: { "X-API-Key": "afk_your_api_key_here" },
}).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);Input schema
Request parameters accepted by the Wan 2.7 R2V endpoint. Model-specific options are nested under the params object shown below.
| Parameter | Type | Required | Default | Allowed / range | Description |
|---|---|---|---|---|---|
| prompt | string | required | — | — | Text description of what to generate. |
| model | string | required | "wan-2.7-r2v" | "wan-2.7-r2v" | The model identifier for this endpoint. |
| wan27R2vParams.reference_images | string[] (URLs) | optional | — | — | Up to 5 reference images for character / style anchoring. |
| wan27R2vParams.reference_videos | string[] (URLs) | optional | — | — | Up to 5 reference videos for motion / scene anchoring. |
| wan27R2vParams.resolution | string | optional | "720p" | "720p", "1080p" | Resolution |
| wan27R2vParams.shot_type | string | optional | "single" | "single", "multi" | Shot type |
| wan27R2vParams.negative_prompt | string | optional | — | — | Negative prompt |
| wan27R2vParams.seed | number | optional | — | step 1 | Reuse a number to reproduce the same result. |
Frequently Asked Questions
Common questions about the Wan 2.7 R2V API.
Is there an API for Wan 2.7 R2V?
Yes. Apiframe exposes Wan 2.7 R2V through a single REST endpoint (`POST /v2/videos/generate` with `model: "wan-2.7-r2v"`). You get one unified API, key, and billing across every supported model — no separate Alibaba account required.
How much does the Wan 2.7 R2V API cost?
Wan 2.7 R2V uses simple pay-as-you-go pricing on Apiframe — you only pay for successful generations. See the pricing page for plans and volume discounts.
How do I call the Wan 2.7 R2V API?
Send a POST request to `/v2/videos/generate` with your `X-API-Key` and a JSON body containing `model: "wan-2.7-r2v"`. The call returns a `jobId`; poll `GET /v2/jobs/{id}` or use a webhook to receive the result.
What parameters does Wan 2.7 R2V support?
Wan 2.7 R2V accepts 6 model-specific parameters (nested under `wan27R2vParams`) plus the common `prompt` and `webhook_url` fields. See the input schema above for the full list with types and defaults.
Still have questions?
Start building with the Wan 2.7 R2V API
Get your API key and integrate Wan 2.7 R2V in minutes — Pay-as-you-go.
Questions? Join our Discord or contact sales.