Zum Hauptinhalt springen
POST
/
v3
/
async
/
vidu-q1-reference2video
Vidu Q1 Referenz-zu-Video
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q1-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 Q1 Referenz-zu-Video generiert Videos anhand von Referenzbildern und Textbeschreibungen. Es unterstützt verschiedene Motive, z. B. Charaktere und Objekte. Durch das Hochladen mehrerer Ansichten eines Motivs können Sie Videos erstellen, die visuell konsistent bleiben.
Dies ist eine asynchrone API, die nur die task_id der asynchronen Aufgabe zurückgibt. Sie sollten diese task_id verwenden, um die API zum Abfragen des Aufgabenergebnisses aufzurufen und das Ergebnis der Videogenerierung abzurufen.

Anforderungsheader

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

Anfragetext

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 7 Bilder
  • Bildressourcen können per URL oder Base64-Codierung bereitgestellt werden
  • Es muss eines der folgenden Formate 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 50 MB begrenzt
  • Die Länge nach der Base64-Decodierung muss kleiner als 10 MB sein und eine geeignete Content-Type-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. Standardmäßig 5 Sekunden; derzeit wird nur die Option 5 Sekunden unterstützt.
seed
integer
Zufalls-Seed für die Videogenerierung.
  • Standardmäßig ein zufälliger Seed-Wert
  • Ein manuell gesetzter Wert überschreibt den standardmäßigen Zufalls-Seed
aspect_ratio
string
Das Seitenverhältnis des Ausgabevideos. Standardwert: 16:9
Optionale Werte: 16:9, 9:16, 1:1
resolution
string
Auflösung des Ausgabevideos. Standardmäßig 1080p; derzeit wird nur die Option 1080p unterstützt.
movement_amplitude
string
Die Bewegungsamplitude der Objekte im Bild. Standardwert: auto
Optionale Werte: auto, small, medium, large
bgm
boolean
Ob dem generierten Video Hintergrundmusik hinzugefügt werden soll. Standardwert: false
Optionale Werte: true, false
Wenn auf true gesetzt, fügt das System automatisch passende BGM hinzu. Für die 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 abzurufen