Nutze Wan 3.0 Video über Rivya Public API v1 mit Model-ID wan-3-0-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-3-0-video

Eingaben

text, file

Files API

Für Referenzmodi erforderlich

Basis-Credits

per_input_and_output_second · standard_480P=8 · standard_720P=16 · standard_1080P=32 · prime_480P=12.2 · prime_720P=25.2 · prime_1080P=50.4 · ⌈total⌉

Fähigkeit

Video

Abrechnung

METERED

Prompt-Limit

20000 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-3-0-video	Verwende wan-3-0-video als API-Modell-ID.
prompt	string	Ja	-	Maximal 20000 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
seedance_scene	select	Nein	text	-	text, frames, reference	Wähle vor dem Hochladen von Medien einen exklusiven Eingabevertrag.
variant	select	Nein	standard	-	standard, prime	Standard und Prime nutzen dieselben Einstellungen, aber unterschiedliche Sätze pro Sekunde.
resolution	select	Nein	1080P	-	480P, 720P, 1080P	Die Reservierung entspricht dem Tarif für Variante und Auflösung multipliziert mit verifizierten Eingabevideosekunden plus reservierten Ausgabesekunden; die Gesamtsumme wird einmal aufgerundet. Die intelligente Dauer reserviert 30 Ausgabesekunden und ist mit Referenzvideos nicht verfügbar.
aspect_ratio	select	Nein	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	Wähle einen adaptiven Frame oder ein festes Ausgabeverhältnis.
duration	number	Nein	5	min -1 / max 30 / step 1	-	Wähle -1 für die automatische Dauer oder eine ganze Zahl von 2 bis einschließlich 30 Sekunden. Die automatische Dauer reserviert 30 Ausgabesekunden und kann nicht mit Referenzvideo verwendet werden.
audio	select	Nein	true	-	true, false	Wähle, ob das generierte Video vom Modell erstelltes Audio enthalten soll.
seed	number	Nein	-	min 0 / max 2147483647 / step 1	-	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

Leitframes oder signierte multimodale Referenzen: Frames akzeptiert ein erforderliches Startbild und ein optionales Endbild. Referenz akzeptiert bis zu 10 JPEG-, nicht transparente PNG-, WebP- oder BMP-Bilder mit jeweils 20 MB, 5 MP4/MOV-Videos mit jeweils 95 MB und 1 bis 15 Sekunden sowie 5 MP3/WAV-Audioclips mit jeweils 15 MB und 1 bis 15 Sekunden. Video und Audio sind insgesamt jeweils auf 15 Sekunden begrenzt.

Max. Dateien

Akzeptierte Dateitypen

image, video, audio

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/bmp, image/webp
video	95 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

Minimalrequest

{
  "model": "wan-3-0-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0
  }
}

Request mit Referenzdatei

{
  "model": "wan-3-0-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

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_3_0_video_example",
  "status": "queued",
  "model": "wan-3-0-video",
  "reserved_credits": 160,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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 3.0 Video API-Integration