wan2.7-r2v API

Verwenden Sie die genaue Modell-ID wan2.7-r2v. Das Modellfeld muss genau mit dieser Seite übereinstimmen.

Beispielausgabewan2.7-r2vPOST /v1/videos5.0s

Parameter: duration=5resolution=1080Pratio=16:9Referenzbild

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.

Anfrage, die dieses Beispiel erstellt hat, wobei die Eingabemedien-URL ersetzt wurde

{
  "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"
  }
}

Authentifizierung und Endpunkt

Verwenden Sie einen Modelflare-API-Schlüssel mit https://modelflare.dev/v1. Der Gateway-Einstiegspunkt ist POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Erstellen Sie eine Aufgabe

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}
  }'

Umfrage und Download

Speichern Sie die Aufgaben-ID. Abfrage GET /v1/videos/{task_id} und Download mit GET /v1/videos/{task_id}/content. Ergebnis-URLs können ablaufen. Übertragen Sie die Datei daher umgehend.

bash

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

Notizen anfordern

Wan verwendet üblicherweise input und parameters; Frame-Guided- und Reference-Media-Modi dürfen nicht gemischt werden.

Parameter anfordern

Wan2.7 R2V verwendet reference_image/reference_video-Medien und kann reference_voice anhängen. Mischen Sie diesen Workflow nicht mit den Rollen first_frame/last_frame.

Feld	Erforderlich	Notizen
model	Ja	wan2.7-r2v
input.prompt	Ja	Beschreiben Sie die Szene und das Referenzmedium mithilfe der dokumentierten Syntax
input.media[]	Ja	Mindestens ein reference_image oder reference_video
input.media[].reference_voice	Nein	Öffentliche WAV/MP3-URL für Spracheigenschaften
parameters.resolution	Nein	720P / 1080P (Standard 1080P)
parameters.ratio	Nein	16:9 / 9:16 / 1:1 / 4:3 / 3:4 (wird ignoriert, wenn first_frame vorhanden ist)
parameters.duration	Nein	Verwenden Sie die kürzere Dauerbegrenzung, wenn ein Referenzvideo vorhanden ist
parameters.prompt_extend	Nein	Legen Sie „false“ fest, wenn dieser dedizierte Modellvertrag dies erfordert
parameters.watermark	Nein	Ob ein Wasserzeichen hinzugefügt werden soll
parameters.seed	Nein	Optionaler zufälliger Startwert

Eingabe- und Ausgabegrenzen

R2V erfordert mindestens ein reference_image oder reference_video mit höchstens fünf Referenzbildern/-videos zusammen. Es können ein first_frame und ein reference_voice angeschlossen werden; Die Dauerbegrenzung ist kürzer, wenn ein Referenzvideo vorhanden ist.

Dokumentierte Workflow-Beispiele

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}
  }'

Fehler und fehlgeschlagene Aufgaben

Ungültige Modellparameter geben ein 4xx mit einer Anforderungs-ID zurück. Eine asynchrone Aufgabe kann auch nach erfolgreicher Erstellung als fehlgeschlagen gelten. Verwenden Sie error_code und error_message aus der Umfrageantwort als letzten Aufgabengrund. Wiederholen Sie dieselbe Anfrage nicht mit einer anderen JSON-Form.

Unterstützter Bereich

Auf dieser Seite werden Modelflare-Modellgenerierungs- und -bearbeitungsaufrufe behandelt. Such- oder Kartenanreicherung, Sprachverwaltung und Elementbibliotheksverwaltung sind Ressourcen-APIs außerhalb dieser öffentlichen Modellaufrufoberfläche und keine erforderlichen Anforderungsfelder.

Preise und Abrechnung

Dieses Modell verwendet eine Videoabrechnung pro Sekunde. Den aktuellen Kundenpreis, den Referenzlistenpreis und die vollständige Spezifikation finden Sie auf der Modellpreisseite.

Hinweis

Diese Seite dokumentiert die öffentliche Schnittstelle von Modelflare. Bei den hier dargestellten Feldern und Grenzen handelt es sich um den aktuellen Vertrag.

Varianten

Modell-ID	Unterschied
wan2.7-r2v	Das auf dieser Seite dokumentierte Modell.