Skip to main content
POST

Autorisierung

string
erforderlich
Alle API-Endpunkte erfordern eine Bearer-Token-AuthentifizierungAPI-Key abrufen:Besuchen Sie die Seite zur API-Key-Verwaltung, um Ihren API-Key zu erhaltenFügen Sie ihn zum Request-Header hinzu:

Modus-Routing

wan2.7 ist ein einheitlicher Einstieg für Text-to-Video und Image-to-Video. Das Backend ermittelt den Modus automatisch anhand der eingehenden Parameter. Beide Modi werden identisch abgerechnet:

Anfrageparameter

string
erforderlich
Name des Videogenerierungsmodells, fest auf wan2.7
boolean
Standard:"false"
Legt fest, ob der Inhalt vor dem Absenden des Videoauftrags moderiert wird.
  • true: Prompts und Eingabebilder mit omni-moderation-latest prüfen
  • false oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)
string
Beschreibung des Videoinhalts, bis zu 5000 Zeichen
  • Text-to-Video-Modus (wenn kein Bild/Video übergeben wird): erforderlich
  • Image-to-Video-Modus: optional, aber empfohlen zur Steuerung von Kamerabewegung und Aktionen
Beispiel: "A cat chasing butterflies on the grass, bright sunshine, slow motion"
array<string>
Array von Bild-URLs. Wird dieses Feld angegeben, wird automatisch der Image-to-Video-Modus aktiviert
  • 1 Bild: Erstes Einzelbild zu Video
  • 2 Bilder: Erstes-letztes Einzelbild zu Video (1. = erstes Einzelbild, 2. = letztes Einzelbild)
Verwenden Sie entweder dieses Feld oder image_with_roles
image_urls steht in Konflikt mit audio_url; sie können nicht gleichzeitig angegeben werden
array<object>
Array von Bildern mit Rollen, Alternative zu image_urls, zur exakten Angabe der Rolle jedes BildesFelder jedes Objekts:
  • url (string): Bild-URL (unterstützt http/https)
  • role (string): Bildrolle, first_frame / last_frame, Standard first_frame
Beispiel:
image_with_roles steht in Konflikt mit audio_url; sie können nicht gleichzeitig angegeben werden
array<string>
Array von Video-URLs. Wird dieses Feld angegeben, wird der Modus Videofortsetzung aktiviert (es wird nur das 1. Video verwendet)
video_urls steht in Konflikt mit audio_url; sie können nicht gleichzeitig angegeben werden
Videobeschränkungen:
  • Format: mp4, mov
  • Dauer: 2–10s
  • Auflösung: Breite und Höhe im Bereich [240, 4096] Pixel
  • Seitenverhältnis: 1:8 – 8:1
  • Dateigröße: bis zu 100 MB
string
Negativer Prompt zur Beschreibung unerwünschter Inhalte, bis zu 500 ZeichenBeispiel: "blurry, distorted, low quality"
string
Standard:"1080P"
VideoauflösungOptionen:
  • 720P – Standard
  • 1080P – Hohe Auflösung (Standard)
integer
Standard:"5"
Videodauer (Sekunden)Unterstützter Bereich: 2 ~ 15 SekundenStandard: 5
string
Standard:"16:9"
Seitenverhältnis, nur im Text-to-Video-Modus wirksam (wenn kein Bild/Video übergeben wird)Unterstützte Formate:
  • 16:9 – Querformat Breitbild (Standard)
  • 9:16 – Hochformat
  • 1:1 – Quadrat
  • 4:3 – Querformat
  • 3:4 – Hochformat
Dieser Parameter wird im Image-to-Video-Modus ignoriert; das Seitenverhältnis wird automatisch durch das Eingabebild bestimmt
string
URL einer benutzerdefinierten Audiospur
  • Text-to-Video-Modus: wird als Hintergrundmusik verwendet
  • Image-to-Video-Modus: wird als steuerndes Audio verwendet, synchronisiert mit den Aktionen im Bild
Format: wav / mp3, Dauer 2–30 Sekunden, Dateigröße ≤ 15 MB
audio_url steht in Konflikt mit video_urls, image_urls und image_with_roles; sie können nicht gleichzeitig angegeben werden
boolean
Standard:"true"
Soll die intelligente Prompt-Umschreibung aktiviert werden?Verbessert die Ergebnisse für kurze Prompts deutlich, erhöht aber die VerarbeitungszeitStandard: true
boolean
Standard:"false"
Soll dem generierten Video ein „AI Generated”-Wasserzeichen hinzugefügt werden?
  • true: Wasserzeichen hinzufügen
  • false: kein Wasserzeichen (Standard)
integer
Ganzzahliger Seed zur Steuerung der Zufälligkeit des generierten InhaltsWertebereich: Ganzzahl ≥ 0
  • Bei identischen Anfragen erzeugt das Modell unterschiedliche Ergebnisse, wenn unterschiedliche Seed-Werte empfangen werden (z. B. ohne Seed)
  • Bei identischen Anfragen erzeugt das Modell ähnliche Ergebnisse, wenn derselbe Seed-Wert empfangen wird, eine exakte Übereinstimmung ist jedoch nicht garantiert

Antwort

integer
Statuscode der Antwort, 200 bei Erfolg
array
Datenarray der Antwort

Anwendungsfälle

Fall 1: Text-zu-Video (einfachste Anfrage)

Fall 2: Text-zu-Video (vollständige Parameter)

Fall 3: Erstes Einzelbild zu Video

Fall 4: Erstes-letztes Einzelbild zu Video

Bei 2 Bildern: Das 1. ist das erste Einzelbild, das 2. das letzte. Sie können auch image_with_roles für eine präzise Angabe verwenden.

Fall 5: Videofortsetzung

Fall 6: Bild + steuerndes Audio

Leitfaden zur Moduswahl

Aufgabenergebnisse abfragenDie Videogenerierung ist eine asynchrone Aufgabe, die nach der Übermittlung eine task_id zurückgibt. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um den Generierungsfortschritt und die Ergebnisse abzufragen.