Zum Hauptinhalt springen
POST
/
v3
/
async
/
vidu-q2-pro-startend2video
VIDU Q2 Pro Start- und Endframe
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-pro-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 zusammenhängendes Video basierend auf zwei Bildern als Start- und Endframe. Unterstützt die drei Auflösungen 540p, 720p und 1080p.
Dies ist eine asynchrone API, die nur die task_id der asynchronen Aufgabe zurückgibt. Verwenden Sie diese task_id, um über die API zum Abfragen von Aufgabenergebnissen 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 der voreingestellten BGM-Bibliothek aus und fügt sie hinzu; false: Es wird keine BGM hinzugefügt. Für BGM gibt es keine Längenbeschränkung; das System passt sie automatisch an die Videolänge an.
​
seed
integer
Zufalls-Seed. Wenn er standardmäßig nicht übergeben wird oder 0 übergeben wird, wird stattdessen eine Zufallszahl verwendet; bei manueller Festlegung wird der gesetzte Seed verwendet.
​
images
array
erforderlich
Bild-Array: Das erste Bild gilt als Startframe, das zweite Bild als Endframe. Das Modell verwendet die in diesem Parameter übergebenen Bilder zur Videogenerierung. 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: Es werden Base64-codierte Bilder oder Bild-URLs unterstützt (stellen Sie sicher, dass sie zugänglich sind). 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 Inhaltstyp-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 (verbraucht pro Aufgabe zusätzlich 10 Credits); false: Nein, das Video wird gemäß dem eingegebenen prompt generiert.
​
prompt
string
Text-Prompt, die textuelle Beschreibung zur 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ängenbeschränkung: 0 - 2000
​
wm_url
string
Wasserzeicheninhalt, hier eine Bild-URL. Wenn nicht übergeben, wird das Standardwasserzeichen verwendet: Inhalt von AI generiert
​
payload
string
Durchleitungsparameter; wird nicht verarbeitet, sondern nur zur Datenübertragung verwendet. Maximal 1048576 Zeichen.Längenbeschränkung: 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: Videoerstellung zu Nebenzeiten (geringerer Credit-Verbrauch, Erstellung innerhalb von 48 Stunden); false: sofortige Videoerstellung. Hinweis: Aufgaben, die im Nebenzeitenmodus eingereicht wurden und nicht abgeschlossen werden können, werden automatisch storniert und die Credits werden zurückerstattet; Sie können Nebenzeiten-Aufgaben auch manuell stornieren.
​
meta_data
string
Metadatenkennung, JSON-Format-Zeichenfolge, Durchleitungsfeld. 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. Über den Parameter watermarked_url können Sie 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 Position 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 der Objekte im VideoOptionale Werte: auto, small, medium, large

​
Antwortinformationen

​
task_id
string
erforderlich
Verwenden Sie task_id, um über die API zum Abfragen von Aufgabenergebnissen die generierte Ausgabe abzurufen.
​
provider_request_id
string
Provider request ID (optional)