> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# VIDU Q2 Szenenvorlagen

Generiert anhand einer Szenenvorlage und eines Eingabebilds ein Video mit Spezialeffekten. Unterstützt mehrere Szenenvorlagen; unterschiedliche Vorlagen unterstützen unterschiedliche Effektparameter.

<Tip>
  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](/de/docs/models/reference-get-async-task-result) aufrufen, um das generierte Ergebnis abzurufen.
</Tip>

## Request-Header

<ParamField header="Content-Type" type="string" required={true}>
  Enumerationswert: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer-Authentifizierungsformat: Bearer \{\{API Key}}.
</ParamField>

## Request-Body

<ParamField body="bgm" type="boolean" default={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.
</ParamField>

<ParamField body="area" type="string" default="auto">
  Exklusiver Parameter für den Spezialeffekt „Exotische Prinzessin“. Nur verfügbar, wenn template auf exotic\_princess gesetzt ist. Standard: auto

  Mögliche Werte: `auto`, `denmark`, `uk`, `africa`, `china`, `mexico`, `switzerland`, `russia`, `italy`, `korea`, `thailand`, `india`, `japan`
</ParamField>

<ParamField body="seed" type="integer" default={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.
</ParamField>

<ParamField body="beast" type="string" default="auto">
  Exklusiver Parameter für den Spezialeffekt „Mit dem Tier unterwegs“. Nur verfügbar, wenn template auf beast\_companion gesetzt ist. Standard: auto

  Mögliche Werte: `auto`, `bear`, `tiger`, `elk`, `snake`, `lion`, `wolf`
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  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
</ParamField>

<ParamField body="prompt" type="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.
</ParamField>

<ParamField body="wm_url" type="string">
  Wasserzeicheninhalt, hier als Bild-URL. Wenn nicht übergeben, wird das Standardwasserzeichen verwendet: Inhalt von AI generiert.
</ParamField>

<ParamField body="payload" type="string">
  Durchleitungsparameter; wird nicht verarbeitet, sondern nur zur Datenübertragung verwendet. Maximal 1048576 Zeichen

  Längenbeschränkung: 0 - 1048576
</ParamField>

<ParamField body="template" type="string" required={true}>
  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](https://platform.vidu.cn/docs/templates)
</ParamField>

<ParamField body="meta_data" type="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"}`
</ParamField>

<ParamField body="watermark" type="boolean" default={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.
</ParamField>

<ParamField body="wm_position" type="integer" default={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 3

  Mögliche Werte: `1`, `2`, `3`, `4`
</ParamField>

<ParamField body="aspect_ratio" type="string" default="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`
</ParamField>

## Antwortinformationen

<ResponseField name="task_id" type="string" required={true}>
  Verwenden Sie die task\_id, um die [API zum Abfragen des Aufgabenergebnisses](/de/docs/models/reference-get-async-task-result) aufzurufen und die generierte Ausgabe abzurufen.
</ResponseField>

<ResponseField name="provider_request_id" type="string" required={false}>
  Anbieter-Request-ID (optional)
</ResponseField>