Nutze Wan 2.7 Video über Rivya Public API v1 mit Model-ID wan-2-7-video, unterstützten Eingaben, Parametern, Files-API-Regeln, Credits und Response-Beispielen.

Über API verfügbarText oder URL bereit; Referenzmodi nutzen Files APIVideo

API-Modell-ID

wan-2-7-video

Eingaben

text, file

Files API

Für Referenzmodi erforderlich

Basis-Credits

Fähigkeit

Video

Abrechnung

FIXED

Prompt-Limit

5000 Zeichen

Request-Kontrakt

Sende die Modell-ID auf Top-Level. Modellspezifische Controls gehören in params.

Key	Typ	Erforderlich	Standard	Beschreibung
model	string	Ja	wan-2-7-video	Verwende wan-2-7-video als API-Modell-ID.
prompt	string	Ja	-	Maximal 5000 Zeichen für dieses Modell.
params	object	Nein	-	Modellspezifisches Parameterobjekt. Die erlaubten Keys stehen in den Zeilen darunter.
client_request_id	string	Nein	-	Optionale Client-ID, um Requests in deinem System nachzuverfolgen.

Modellparameter

Key	Typ	Erforderlich	Standard	Bereich	Optionen	Beschreibung
resolution	select	Nein	720p	-	720p, 1080p	Auflosung
duration	select	Nein	5	-	5, 10, 15	Text- und Bildlaufe konnen 5, 10 oder 15 Sekunden nutzen. Videobearbeitung endet derzeit bei 10 Sekunden, und Rivya normalisiert langere Auswahl in diesem Modus automatisch.
aspect_ratio	select	Nein	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4	Text-zu-Video- und Video-Editing-Laufe verwenden dies direkt. Bild-zu-Video folgt derzeit der Geometrie des hochgeladenen Frames statt eines separaten Seitenverhaltnis-Schalters.
negative_prompt	text	Nein	-	-	-	Negativer Prompt
prompt_extend	select	Nein	true	-	true, false	Steuert, ob das Modell deinen Prompt vor der Generierung umschreibt. Lass es fur Komfort eingeschaltet oder deaktiviere es, wenn du bereits einen sehr prazisen Prompt hast.
watermark	select	Nein	false	-	false, true	Wasserzeichen
audio_setting	select	Nein	auto	-	auto, origin	Steuert, wie Audio im Video-Edit-Pfad behandelt wird. Auto lasst das Modell entscheiden, wahrend Keep original versucht, das Audio des Quellvideos zu erhalten.
seed	number	Nein	-	min 0 / max 2147483647	-	Lass das Feld leer, um jedes Mal ein neues zufälliges Ergebnis zu erhalten. Wenn du dieselbe Ganzzahl erneut verwendest, lässt sich ein früheres Ergebnis leichter reproduzieren oder feinabstimmen. Es bleibt nur dann näher am Original, wenn Prompt und andere wichtige Einstellungen ebenfalls ähnlich bleiben, und es ist keine garantierte 1:1-Übereinstimmung.

Upload-Richtlinie

Lade zuerst Referenzdateien hoch und setze dann die zurückgegebene URL und den durationToken in params.referenceMediaItems.

Referenzregel

Referenzmedien: Lade bis zu 2 Assets hoch. Nutze bis zu 2 Bilder fur Bild-zu-Video oder 1 Video plus 1 optionales Bild fur Videobearbeitung.

Max. Dateien

Akzeptierte Dateitypen

image, video

Duration Token

Video- und Audioreferenzen sollten durationToken aus /api/v1/files mitführen, wenn eine Dauerprüfung erforderlich ist.

kind	Max. Größe	MIME-Typen
image	20 MB	image/jpeg, image/png, image/webp
video	95 MB	video/mp4, video/quicktime

Minimalrequest

{
  "model": "wan-2-7-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Optionale Ausschlusse oder zu vermeidende Fehlermodi.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

Request mit Referenzdatei

{
  "model": "wan-2-7-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Optionale Ausschlusse oder zu vermeidende Fehlermodi.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Create-Response

Der Create-Endpunkt gibt eine öffentliche Task-ID zurück. Frage den Status-Endpunkt ab, bis der Task erfolgreich ist oder fehlschlägt.

{
  "id": "task_wan_2_7_video_example",
  "status": "queued",
  "model": "wan-2-7-video",
  "reserved_credits": 80,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Häufige Fehler

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Einige Modi benötigen Referenz-Uploads über Files API.

Wan 2.7 Video API-Integration