wan2.7-r2v API

Use the exact wan2.7-r2v model ID through Modelflare asynchronous video routing.

Use the exact model ID wan2.7-r2v. The model field must match this page exactly.

Authentication and endpoint

Use a Modelflare API key with https://modelflare.dev/v1. The gateway entry point is POST /v1/videos.

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Create a task

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-r2v",
    "input": {"prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"},
    "parameters": {"resolution": "1080P", "duration": 5, "prompt_extend": false}
  }'

Poll and download

Save the task ID. Poll GET /v1/videos/{task_id} and download with GET /v1/videos/{task_id}/content. Result URLs may expire, so transfer the file promptly.

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Request notes

Wan commonly uses input and parameters; frame-guided and reference-media modes must not be mixed.

Request parameters

Wan2.7 R2V uses reference_image/reference_video media and may attach reference_voice. Do not mix this workflow with first_frame/last_frame roles.

Field	Required	Notes
model	Yes	wan2.7-r2v
input.prompt	Yes	Describe the scene and reference media using the documented syntax
input.media[]	Yes	At least one reference_image or reference_video
input.media[].reference_voice	No	Public WAV/MP3 URL for voice characteristics
parameters.resolution	No	720P / 1080P
parameters.duration	No	Use the shorter duration limit when a reference video is present
parameters.prompt_extend	No	Set false when this dedicated model contract requires it

Input and output limits

R2V requires at least one reference_image or reference_video, with at most five reference images/videos combined. One first_frame and a reference_voice may be attached; the duration limit is shorter when a reference video is present.

Supported scope

This page covers Modelflare model generation and editing calls. Search or map enrichment, voice management, and element-library management are resource APIs outside this public model-call surface and are not required request fields.

Pricing and billing

This model uses per-second video billing. See the model pricing page for the current customer price, reference list price, and complete specification.

This page documents Modelflare’s public interface; the fields and limits shown here are the current contract.