Zum Hauptinhalt springen
POST
/
v3
/
async
/
vidu-q2-pro-fast-startend2video
VIDU Q2 Pro Fast Start- und Endframe
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-startend2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "seed": 123,
  "images": [
    {}
  ],
  "is_rec": true,
  "prompt": "<string>",
  "wm_url": "<string>",
  "payload": "<string>",
  "duration": 123,
  "off_peak": true,
  "meta_data": "<string>",
  "watermark": true,
  "resolution": "<string>",
  "wm_position": 123,
  "movement_amplitude": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
Generiert ein kohärentes Video aus zwei Bildern als Start- und Endframe (Schnellmodus). Unterstützt die beiden Auflösungen 720p und 1080p. Der Schnellmodus kann die Generierungszeit deutlich verkürzen und eignet sich für Szenarien mit hohen Geschwindigkeitsanforderungen.
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 anzufordern und das generierte Ergebnis abzurufen.

​
Anfrageheader

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

​
Anfragetext

​
bgm
boolean
Standard:false
Gibt an, ob dem generierten Video Hintergrundmusik hinzugefügt werden soll. true: Das System wählt automatisch passende Musik aus einer vordefinierten BGM-Bibliothek aus und fügt sie hinzu; false: Es wird keine BGM hinzugefügt. Für BGM gibt es keine Beschränkung der Dauer; das System passt sie automatisch an die Videolänge an.
​
seed
integer
Zufalls-Seed. Wenn er standardmäßig nicht übergeben oder als 0 übergeben wird, wird stattdessen eine Zufallszahl verwendet; bei manueller Einstellung wird der festgelegte Seed verwendet.
​
images
array
erforderlich
Bildarray: Das erste Bild wird als Startframe und das zweite Bild als Endframe betrachtet; das Modell generiert das Video anhand der in diesem Parameter übergebenen Bilder. Die Eingabe von zwei Bildern wird unterstützt. Hinweis 1: Die Auflösungen der beiden Eingabebilder für Start- und Endframe müssen ähnlich sein; das Verhältnis Auflösung des Startframes/Auflösung des Endframes muss zwischen 0.8 und 1.25 liegen. Hinweis 2: Die Übergabe von Bildern als Base64-Codierung oder als Bild-URL (Zugänglichkeit sicherstellen) wird unterstützt. Hinweis 3: Unterstützte Bildformate sind png, jpeg, jpg und webp. Hinweis 4: Die Bildgröße darf 50M nicht überschreiten. Hinweis 5: Die Base64-Codierung muss eine geeignete Content-Type-Zeichenfolge enthalten, z. B.: data:image/png;base64,Array-Länge: 2 - 2
​
is_rec
boolean
Standard:false
Gibt an, ob empfohlene Prompts verwendet werden sollen. true: Ja, das System empfiehlt automatisch Prompts und verwendet deren Inhalt zur Videogenerierung (jede Aufgabe verbraucht zusätzlich 10 Credits); false: Nein, das Video wird anhand des eingegebenen prompt generiert.
​
prompt
string
Text-Prompt, eine textuelle Beschreibung für die Videogenerierung. Hinweis 1: Die Zeichenlänge darf 2000 Zeichen nicht überschreiten. Hinweis 2: Wenn der Parameter is_rec für empfohlene Prompts verwendet wird, berücksichtigt das Modell den in diesem Parameter eingegebenen Prompt nicht.Längenbegrenzung: 0 - 2000
​
wm_url
string
Wasserzeicheninhalt, hier eine Bild-URL. Wenn nicht übergeben, wird das Standardwasserzeichen verwendet: Inhalt von KI generiert
​
payload
string
Durchgereichter Parameter, ohne jegliche Verarbeitung, nur zur Datenübertragung. Maximal 1048576 Zeichen.Längenbegrenzung: 0 - 1048576
​
duration
integer
Standard:5
Videodauer (Sekunden), unterstützt 1–8 SekundenOptionale Werte: 1, 2, 3, 4, 5, 6, 7, 8
​
off_peak
boolean
Standard:false
Off-Peak-Modus. true: Video im Off-Peak-Modus generieren (geringerer Credit-Verbrauch, Generierung innerhalb von 48 Stunden); false: Video sofort generieren. Hinweis: Aufgaben, die im Off-Peak-Modus eingereicht wurden und nicht abgeschlossen werden konnten, werden automatisch storniert und die Credits zurückerstattet; Sie können Off-Peak-Aufgaben auch manuell stornieren.
​
meta_data
string
Metadatenkennung, JSON-formatierte Zeichenfolge, durchgereichtes Feld. Sie können ein eigenes Format definieren oder das Beispielformat verwenden. Wenn dieser Parameter leer ist, wird standardmäßig die von vidu generierte Metadatenkennung verwendet.
​
watermark
boolean
Standard:false
Gibt an, ob ein Wasserzeichen hinzugefügt werden soll. Standardmäßig wird kein Wasserzeichen hinzugefügt. Sie können den Videoinhalt mit Wasserzeichen über den Parameter watermarked_url abfragen.
​
resolution
string
Standard:"720p"
Auflösung des Ausgabevideos. Unterstützt 720p und 1080p. Standardwert ist 720p.Optionale Werte: 720p, 1080p
​
wm_position
integer
Standard:3
Wasserzeichenposition, gibt an, an welcher Stelle im Bild das Wasserzeichen erscheint. 1: oben links; 2: oben rechts; 3: unten rechts (Standard); 4: unten linksOptionale Werte: 1, 2, 3, 4
​
movement_amplitude
string
Standard:"auto"
Bewegungsamplitude, steuert die Bewegungsstärke von Objekten im VideoOptionale Werte: auto, small, medium, large

​
Antwortinformationen

​
task_id
string
erforderlich
Verwenden Sie die task_id, um die API zum Abfragen des Aufgabenergebnisses anzufordern und die generierte Ausgabe abzurufen.
​
provider_request_id
string
Provider-Anfrage-ID (optional)