Skip to main content
POST

Autorisierung

string
erforderlich
Alle Endpunkte erfordern eine Bearer-Token-AuthentifizierungAPI-Key über die Seite zur API-Key-Verwaltung abrufen:

Generierungsmodi

Modellname ist fest wan3.0-video. Der Modus ergibt sich aus den Anfragefeldern:

Anfrageparameter

Grundlagen

string
erforderlich
Fester Wert: wan3.0-video
string
Textbeschreibung. Erforderlich, sofern keine Medienfelder angegeben sind (mindestens Prompt oder Medien).
  • Max. 20.000 Zeichen; Überschuss wird ohne Fehler automatisch abgeschnitten
  • Im Referenzmodus mit „图N / 视频N / 音频N“ auf Assets verweisen; Indizes folgen der Reihenfolge innerhalb jedes Medientyps
string
Standard:"1080P"
Ausgabeauflösung (Groß-/Kleinschreibung egal)
  • 480P
  • 720P
  • 1080P (Standard, höchster Preis)
Ohne resolution wird mit 1080P abgerechnet. Bei Kostenbewusstsein explizit 480P oder 720P übergeben.
string
Standard:"adaptive"
Seitenverhältnis. aspect_ratio wird ebenfalls akzeptiert.
  • adaptive (Standard)
  • 16:9 / 4:3 / 1:1 / 3:4 / 9:16
integer
Standard:"5"
Dauer in Sekunden, 2–30, Standard 5
duration: -1 (intelligente Dauer) wird nicht unterstützt. Ganzzahl von 2 bis 30 übergeben.
Bei Referenzvideo-Eingabe muss Gesamtdauer der Eingabevideos + Ausgabe-duration ≤ 30 Sekunden sein.
boolean
Standard:"true"
Ob die Ausgabe eine Audiospur enthält. Standard true. Preis ist mit und ohne Audio gleich.
integer
Zufalls-Seed im Bereich [0, 2147483647]
boolean
Standard:"false"
Ob ein Wasserzeichen hinzugefügt wird. Standard false
string
Wie bloße image_urls klassifiziert werden:
  • frame — Familie erstes/letztes Einzelbild
  • reference — Referenzfamilie
Ohne Angabe automatische Klassifikation (siehe gegenseitige Ausschlussregeln).

Medieneingaben

string[]
Array von Bild-URLs. Rollenzuweisung folgt den gegenseitigen Ausschlussregeln.Öffentliche URL oder Base64 (data:image/png;base64,...).
object[]
Bilder mit expliziten Rollen. Jedes Element:
  • url: Bildadresse
  • role: first_frame / last_frame / reference_image (übliche Aliase akzeptiert)
string[]
Referenzvideos, bis zu 5 Clips; je 1–15 s, gesamt ≤ 15 s
string[]
Referenzaudio, bis zu 5 Clips; je 1–15 s, gesamt ≤ 15 s
string
Einzelnes Referenzaudio (Einzelwertform von audio_urls)
string
URL des Referenzdokuments, höchstens 1. Nicht zusammen mit link_url.Formate u. a. docx / doc / xlsx / xls / pptx / ppt / pdf / txt / key / pages / numbers / md, ≤100 MB, ≤50 Seiten.
Öffentliche Webseiten-URL, höchstens 1. Nur Seiten ohne Login. Nicht zusammen mit file_url.

Gegenseitiger Ausschluss von Medienfamilien

Medien gehören zu einer von zwei Familien und dürfen nicht gemischt werden (Validierung vor Submit → 400, kein Task, keine Abrechnung):

Zuordnung bloßer image_urls

  1. Wenn generation_type gesetzt → diesen verwenden (frame / reference)
  2. Sonst, wenn die Anfrage bereits Eingaben der Referenzfamilie hat (video_urls / audio_urls / audio_url / file_url / link_url) → als reference_image behandeln
  3. Sonst → Frame-Familie: erstes Element first_frame, zweites last_frame (wie bei wan2.7)
Für explizite Steuerung image_with_roles verwenden.

Medienlimits und Formate

Anfragebeispiele

Text-to-Video

Erstes-Einzelbild-Video

Erstes + letztes Einzelbild

Oder mit image_with_roles:

Multimodale Referenz

Bei vorhandenen video_urls werden bloße image_urls automatisch als Referenzbilder klassifiziert; generation_type: "reference" macht die Absicht klarer.

Datei-Referenzvideo

prompt kann weggelassen werden; die Generierung wird vom Dokumentinhalt gesteuert:

Webseiten-Referenzvideo

Abrechnung

Pro Sekunde × Auflösung (an offizielle Listenpreise angelehnt). Audio an/aus ändert den Preis nicht:
  • Standard ist 1080P (teuerste Stufe); bei Kostenbewusstsein 480P / 720P übergeben
  • Abrechnungssekunden = angefordertes duration
  • audio: true/false beeinflusst den Preis nicht

Limits und Hinweise

Häufige Fehler

Alle sind synchrone 400 (kein Task, keine Abrechnung):

Response

integer
Statuscode; 200 bei Erfolg
array
Antwortdaten-Array
Ergebnisse abfragenDie Videogenerierung ist asynchron. Task-Status abrufen oder GET /v1/videos/generations/{task_id} pollen.Empfohlenes Intervall 5–10 Sekunden; Generierung dauert typisch 1–5 Minuten. Bei Erfolg URLs in result.videos verwenden.