Zum Hauptinhalt springen
POST
/
v3
/
async
/
vidu-q2-turbo-startend2video
VIDU Q2 Turbo Start- und Endframe
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-turbo-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>"
}
Erstellen Sie schnell ein kohärentes Video aus einem Start- und einem Endbild. Unterstützt die drei Auflösungen 540p, 720p und 1080p. Die Turbo-Version bietet ein ausgewogenes Verhältnis zwischen Generierungsgeschwindigkeit und Videoqualität.
Dies ist eine asynchrone API, die nur die task_id der asynchronen Aufgabe zurückgibt. Verwenden Sie diese task_id, um mit der API zum Abfragen des Aufgabenergebnisses das generierte Ergebnis abzurufen.

Anfrage-Header

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 der voreingestellten BGM-Bibliothek aus und fügt sie hinzu; false: Es wird keine BGM hinzugefügt. BGM ist nicht in der Dauer begrenzt; das System passt sie automatisch an die Videodauer an.
seed
integer
Zufalls-Seed. Wenn er standardmäßig nicht übergeben oder als 0 übergeben wird, wird stattdessen eine Zufallszahl verwendet; bei manueller Festlegung wird der angegebene Seed verwendet.
images
array
erforderlich
Bildarray. Das erste Bild gilt als Startframe, das zweite Bild als Endframe; das Modell generiert das Video anhand der in diesem Parameter übergebenen Bilder. Es werden zwei Eingabebilder 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 Bild-URL wird unterstützt (stellen Sie sicher, dass sie zugänglich ist). Hinweis 3: Bilder in den Formaten png, jpeg, jpg und webp werden unterstützt. 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 generiert das Video anhand des Prompt-Inhalts (jede Aufgabe verbraucht zusätzlich 10 Punkte); false: Nein, das Video wird basierend auf dem eingegebenen prompt generiert.
prompt
string
Text-Prompt, die textuelle Beschreibung zur Generierung des Videos. 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. Wird nichts übergeben, wird das Standardwasserzeichen verwendet: Inhalt von KI generiert.
payload
string
Durchgereichter Parameter, keine Verarbeitung, nur 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
Nebenzeitenmodus. true: Video im Nebenzeitenmodus generieren (geringerer Punkteverbrauch, Generierung innerhalb von 48 Stunden); false: Video sofort generieren. Hinweis: Aufgaben, die im Nebenzeitenmodus eingereicht wurden und nicht abgeschlossen werden können, werden automatisch storniert und die Punkte zurückerstattet; Sie können Nebenzeiten-Aufgaben auch manuell stornieren.
meta_data
string
Metadatenkennung, JSON-Format-Zeichenfolge, durchgereichtes Feld. Sie können ein benutzerdefiniertes Format 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 über den Parameter watermarked_url den Videoinhalt mit Wasserzeichen abrufen.
resolution
string
Standard:"720p"
Auflösung des Ausgabevideos. Der Standardwert ist 720p.Optionale Werte: 540p, 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 Stärke der Bewegung von Objekten im VideoOptionale Werte: auto, small, medium, large

Antwortinformationen

task_id
string
erforderlich
Verwenden Sie die task_id, um mit der API zum Abfragen des Aufgabenergebnisses die generierte Ausgabe abzurufen.
provider_request_id
string
Provider-Request-ID (optional)