Zum Hauptinhalt springen
POST
/
v3
/
async
/
vidu-q2-template2video
VIDU Q2 Szenenvorlagen
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-template2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "area": "<string>",
  "seed": 123,
  "beast": "<string>",
  "images": [
    {}
  ],
  "prompt": "<string>",
  "wm_url": "<string>",
  "payload": "<string>",
  "template": "<string>",
  "meta_data": "<string>",
  "watermark": true,
  "wm_position": 123,
  "aspect_ratio": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
Generiert anhand einer Szenenvorlage und eines Eingabebilds ein Video mit Spezialeffekten. Unterstützt mehrere Szenenvorlagen; unterschiedliche Vorlagen unterstützen unterschiedliche Effektparameter.
Dies ist eine asynchrone API und gibt nur die task_id der asynchronen Aufgabe zurück. Sie sollten mit dieser task_id die API zum Abfragen des Aufgabenergebnisses aufrufen, um das generierte Ergebnis abzurufen.

​
Request-Header

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

​
Request-Body

​
bgm
boolean
Standard:false
Gibt an, ob dem generierten Video Hintergrundmusik hinzugefügt werden soll. Standard: false. Wenn true übergeben wird, wählt das System automatisch passende Musik aus der voreingestellten BGM-Bibliothek aus und fügt sie hinzu; wenn der Parameter nicht übergeben wird oder false ist, wird keine BGM hinzugefügt. BGM ist nicht in der Dauer begrenzt; das System passt sie automatisch an die Videolänge an.
​
area
string
Standard:"auto"
Exklusiver Parameter für den Spezialeffekt „Exotische Prinzessin“. Nur verfügbar, wenn template auf exotic_princess gesetzt ist. Standard: autoMögliche Werte: auto, denmark, uk, africa, china, mexico, switzerland, russia, italy, korea, thailand, india, japan
​
seed
integer
Standard:0
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.
​
beast
string
Standard:"auto"
Exklusiver Parameter für den Spezialeffekt „Mit dem Tier unterwegs“. Nur verfügbar, wenn template auf beast_companion gesetzt ist. Standard: autoMögliche Werte: auto, bear, tiger, elk, snake, lion, wolf
​
images
array
erforderlich
Liste der Eingabebilder. Das Modell verwendet die in diesem Parameter übergebenen Bilder zur Videogenerierung. Unterstützt werden Base64-codierte Bilder oder Bild-URLs (stellen Sie sicher, dass sie zugänglich sind). Bilder in den Formaten png, jpeg, jpg und webp werden unterstützt. Das Bildseitenverhältnis muss kleiner als 1:4 oder 4:1 sein, und die Größe darf 50 MB nicht überschreiten. Die Bytelänge nach dem Base64-Decoding muss kleiner als 10 MB sein, und die Codierung muss eine geeignete Content-Type-Zeichenkette enthalten, zum Beispiel: data:image/png;base64,{base64_encode}Array-Länge: 1 - unbegrenzt
​
prompt
string
Text-Prompt, eine textuelle Beschreibung des zu generierenden Videos. Hinweis: Wenn template=subject_3 oder pubg_winner_hit ist, ist der Prompt nicht erforderlich.
​
wm_url
string
Wasserzeicheninhalt, hier als 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 ZeichenLängenbeschränkung: 0 - 1048576
​
template
string
erforderlich
Parameter für die Szenenvorlage. Unterschiedliche Szenenvorlagen entsprechen unterschiedlichen Aufrufparametern. Häufige Vorlagen: subject_3 (Outfit-Wechsel für Personen), pubg_winner_hit (Battle-Royale-Spezialeffekt), exotic_princess (Exotische Prinzessin), beast_companion (Mit dem Tier unterwegs) usw. Konkrete Vorlagen finden Sie unter: https://platform.vidu.cn/docs/templates
​
meta_data
string
Metadatenkennung, JSON-formatierte Zeichenkette, 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. Beispielformat: {"Label": "your_label", "ContentProducer": "your_content_producer", "ContentPropagator": "your_content_propagator", "ProduceID": "your_product_id", "PropagateID": "your_propagate_id", "ReservedCode1": "your_reserved_code1", "ReservedCode2": "your_reserved_code2"}
​
watermark
boolean
Standard:false
Gibt an, ob ein Wasserzeichen hinzugefügt werden soll. true: Wasserzeichen hinzufügen; false: kein Wasserzeichen hinzufügen. Derzeit ist der Wasserzeicheninhalt fest vorgegeben; der Inhalt wird von AI generiert und standardmäßig nicht hinzugefügt. Sie können den Videoinhalt mit Wasserzeichen über den Parameter watermarked_url abfragen und abrufen.
​
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; 4: unten links. Standard ist 3Mögliche Werte: 1, 2, 3, 4
​
aspect_ratio
string
Standard:"16:9"
Video-Seitenverhältnis. Standard: 16:9; mögliche Werte: 16:9, 9:16. Unterschiedliche template unterstützen unterschiedliche mögliche Werte; Details finden Sie in der Vorlagenbeschreibung.Mögliche Werte: 16:9, 9:16

​
Antwortinformationen

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