Skip to main content
POST

Authentifizierung

string
erforderlich
Alle Endpunkte erfordern eine Authentifizierung mit einem Bearer Token.API Key abrufen:Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API Key zu erhalten.Fügen Sie den folgenden Header zur Anfrage hinzu:

Anfrageparameter

string
erforderlich
Modellname für die Videogenerierung. Fest auf pixverse-v6.
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
erforderlich
Beschreibung des Videoinhalts, bis zu 5000 Zeichen. In allen Modi erforderlich.
string
Standard:"540p"
Videoauflösungsstufe. Beeinflusst die Abrechnung direkt.
  • 360p: SD
  • 540p: Standard (Standard)
  • 720p: HD
  • 1080p: Full HD
Andere Auflösungswerte führen zu einem Parameterfehler.
integer
Standard:"5"
Videolänge in Sekunden, Bereich 1–15.
Der Erst-/Letztbild-Übergangsmodus unterstützt nur 5 oder 8 Sekunden.
string
Standard:"16:9"
Seitenverhältnis des Videos. Wirkt nur in den Modi Text-zu-Video und Multi-Referenzbild-Fusion.
  • 16:9: Querformat Breitbild (Standard)
  • 4:3: Querformat 4:3
  • 1:1: Quadrat
  • 3:4: Hochformat 3:4
  • 9:16: Hochformat
  • 2:3: Hochformat 2:3
  • 3:2: Querformat 3:2
  • 21:9: Kino-Breitbild
integer
Standard:"0"
Zufalls-Seed, Bereich 0–2147483647. Gleiche Prompt + Seed reproduzieren ähnliche Ergebnisse.
string
Negativer Prompt zum Ausschluss unerwünschter Inhalte. Bis zu 2048 Zeichen.
boolean
Standard:"false"
Ob eine Tonspur erzeugt wird.
  • true: Tonspur erzeugen (erhöht den Abrechnungspreis)
  • false: Keine Tonspur (Standard)
boolean
Standard:"false"
Ob ein Wasserzeichen unten rechts hinzugefügt wird.
  • true: Wasserzeichen hinzufügen
  • false: Kein Wasserzeichen (Standard)
string
Bewegungsmodus.
  • normal: Standardmodus (pixverse-v6 unterstützt nur diesen Wert)
fast ist nur für ältere Modelle gedacht und wird vom Upstream für pixverse-v6 abgelehnt.
boolean
Standard:"false"
Ob ein zusammenhängendes Video aus mehreren Clips erzeugt wird. Nur in den Modi Text-zu-Video und Bild-zu-Video unterstützt.
  • true: Multi-Clip-Video erzeugen
  • false: Einzelclip (Standard)
array<url>
URL-Array der Eingabebilder für Bild-zu-Video. Es wird nur das erste Bild verwendet.Bilder müssen öffentlich zugängliche HTTP/HTTPS-URLs sein.
url
URL des ersten Frames im Übergangsmodus. Muss zusammen mit last_frame_image übergeben werden.
url
URL des letzten Frames im Übergangsmodus. Muss zusammen mit first_frame_image übergeben werden.
array<url>
URL-Array der Referenzbilder für den Multi-Referenzbild-Fusionsmodus. Unterstützt 1–7 Bilder.Die Übergabe dieses Feldes löst den Multi-Referenzbild-Fusionsmodus aus.
string
ID der Quellaufgabe für die Video-Verlängerung. Die Übergabe dieses Feldes löst den Verlängerungsmodus aus.Die Quellaufgabe muss dem aktuellen Nutzer gehören, das Modell pixverse-v6 haben und im Status completed sein.

Generierungsmodi

Der Adapter wählt anhand der Anfragefelder automatisch den entsprechenden Modus. Es wird nach Priorität abgeglichen, der erste Treffer gewinnt.
Alle Bildeingaben akzeptieren nur öffentlich zugängliche HTTP/HTTPS-URLs. base64 oder Data URI werden nicht unterstützt. Wenn nur lokale Bilder vorhanden sind, laden Sie sie zuerst in einen Object Storage hoch und übergeben Sie die URL.

Parameterregeln

Antwort

integer
Antwort-Statuscode. Bei Erfolg 200.
array
Zurückgegebenes Aufgaben-Array.

Aufgabenergebnis abrufen

Die Videogenerierung ist eine asynchrone Aufgabe. Nach dem Senden wird task_id zurückgegeben. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um Fortschritt und Ergebnis abzufragen.
cURL
Pollen Sie alle 5 Sekunden, bis der Status completed oder failed lautet.

Beispiel: Erfolg

Die Video-URL liegt unter data.result.videos[0].url[0]. Das url-Feld ist selbst ein Array. Video-Links sind üblicherweise nach 24 Stunden abgelaufen — laden Sie sie rechtzeitig herunter oder transferieren Sie sie.

Beispiel: Fehler

Bei Fehlern ist cost üblicherweise 0. Die Fehlerursache lesen Sie aus data.error.message.

Anwendungsfälle

Fall 1: Text-zu-Video

Fall 2: Bild-zu-Video

Fall 3: Erst-/Letztbild-Übergang

Fall 4: Multi-Referenzbild-Fusion

Fall 5: Video-Verlängerung