Zum Hauptinhalt springen
POST
/
v3
/
async
/
vidu-2.0-reference2video
Vidu 2.0 Referenz-zu-Video
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-2.0-reference2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "images": [
    "<string>"
  ],
  "prompt": "<string>",
  "duration": 123,
  "seed": 123,
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "movement_amplitude": "<string>",
  "bgm": true
}
'
{
  "task_id": "<string>"
}
Vidu 2.0 Referenz-zu-Video generiert Videos anhand von Referenzbildern und Textbeschreibungen. Es unterstützt verschiedene Motive, z. B. Figuren und Objekte. Durch das Hochladen mehrerer Ansichten eines Motivs können Sie Videos erstellen, die visuelle Konsistenz beibehalten.
Dies ist eine asynchrone API und gibt nur die task_id der asynchronen Aufgabe zurück. Sie sollten diese task_id verwenden, um die API zum Abfragen des Aufgabenergebnisses aufzurufen und das Ergebnis der Videogenerierung abzurufen.

​
Anfrage-Header

​
Content-Type
string
erforderlich
Enumerationswert: application/json
​
Authorization
string
erforderlich
Bearer-Authentifizierungsformat: Bearer {{API Key}}.

​
Anfrage-Body

​
images
string[]
erforderlich
Das Modell verwendet die bereitgestellten Bilder als Referenz, um ein Video mit konsistentem Motiv zu generieren.Anforderungen an das Bildfeld:
  • Akzeptiert 1 bis 3 Bilder
  • Bildressourcen können per URL oder Base64-Codierung bereitgestellt werden
  • Eines der folgenden Formate muss verwendet werden: PNG, JPEG, JPG, WebP
  • Die Bildabmessungen müssen mindestens 128x128 Pixel betragen
  • Das Seitenverhältnis des Bildes muss kleiner als 1:4 oder 4:1 sein
  • Alle Bilder sind auf 50MB begrenzt
  • Die Länge nach der base64-Dekodierung muss kleiner als 10MB sein und eine geeignete Inhaltstyp-Zeichenfolge enthalten. Beispiel:
data:image/png;base64,{base64_encode}
​
prompt
string
erforderlich
Der Text-Prompt für die Videogenerierung, mit einer maximalen Länge von 1500 Zeichen.
​
duration
integer
Videodauer (in Sekunden). Standard: 4 Sekunden. Optionen: 4.
​
seed
integer
Zufalls-Seed für die Videogenerierung.
  • Standardmäßig ein zufälliger Seed-Wert
  • Ein manuell festgelegter Wert überschreibt den standardmäßigen Zufalls-Seed
​
aspect_ratio
string
Seitenverhältnis des Ausgabevideos. Standardwert: 16:9
Mögliche Werte: 16:9, 9:16, 1:1
​
resolution
string
Der Auflösungsparameter ist standardmäßig 360p; optional sind 360p und 720p.
​
movement_amplitude
string
Bewegungsamplitude der Objekte im Bild. Standardwert: auto
Mögliche Werte: auto, small, medium, large
​
bgm
boolean
Ob dem generierten Video Hintergrundmusik hinzugefügt werden soll. Standardwert: false
Mögliche Werte: true, falseWenn auf true gesetzt, fügt das System automatisch passende BGM hinzu. Für BGM gibt es keine Längenbeschränkung; das System passt sie automatisch an.

​
Antwortinformationen

​
task_id
string
erforderlich
Die task_id der asynchronen Aufgabe. Sie sollten diese task_id verwenden, um die API zum Abfragen des Aufgabenergebnisses aufzurufen und das Generierungsergebnis zu erhalten