wan2.7-r2v API

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

Sample outputwan2.7-r2vPOST /v1/videos5.0s

Parameters: duration=5resolution=1080Pratio=16:9Reference image

Prompt: One continuous take, no cuts. Keep the glass flowers from the reference exactly as they are and carry them into a new place: a wide city crossing at night in the rain. The whole bed of glass blooms now grows straight out of the wet asphalt across the junction, ringing as the rain strikes them, headlights firing caustics along the road. The camera starts at kerb height among the stems, moves forward through them and rises to look down the length of the crossing. One hard pink key from a shopfront on the left, cold blue signals behind. Real weight and inertia, glass and water, no text.

Request that produced this sample, with the input media URL replaced

{
  "model": "wan2.7-r2v",
  "input": {
    "prompt": "One continuous take, no cuts. Keep the glass flowers from the reference exactly as they are and carry them into a new place: a wide city crossing at night in the rain. The whole bed of glass blooms now grows straight out of the wet asphalt across the junction, ringing as the rain strikes them, headlights firing caustics along the road. The camera starts at kerb height among the stems, moves forward through them and rises to look down the length of the crossing. One hard pink key from a shopfront on the left, cold blue signals behind. Real weight and inertia, glass and water, no text.",
    "media": [
      {
        "type": "reference_image",
        "url": "https://example.com/input-image.png"
      }
    ]
  },
  "parameters": {
    "duration": 5,
    "resolution": "1080P",
    "ratio": "16:9"
  }
}

Authentication and endpoint

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

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Create a task

bash

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": "The subject in Image 1 walks through the street from Video 1.", "media": [{"type": "reference_image", "url": "https://example.com/reference.png"}, {"type": "reference_video", "url": "https://example.com/reference.mp4"}]},
    "parameters": {"resolution": "1080P", "ratio": "16:9", "duration": 5, "prompt_extend": false, "watermark": 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.

bash

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 (default 1080P)
parameters.ratio	No	16:9 / 9:16 / 1:1 / 4:3 / 3:4 (ignored when first_frame is present)
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
parameters.watermark	No	Whether to add a watermark
parameters.seed	No	Optional random seed

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.

Documented workflow examples

bash

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": "让图像主体沿视频动作自然移动", "media": [
      {"type": "reference_image", "url": "https://example.com/subject.png"},
      {"type": "reference_video", "url": "https://example.com/motion.mp4"}
    ]},
    "parameters": {"resolution": "1080P", "duration": 8, "prompt_extend": false}
  }'

Errors and failed tasks

Invalid model parameters return a 4xx with a request ID. An asynchronous task can also enter failed after creation succeeds; use error_code and error_message from the poll response as the final task reason. Do not retry the same request with a different JSON shape.

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.

Note

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

Variants

Model ID	Difference
wan2.7-r2v	The model documented on this page.