> ## 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 Pro Fast Referenzbild/-video zu Video

VIDU Q2 Pro Fast API für Referenzbild/-video zu Video, unterstützt Subjektmodus und Nicht-Subjektmodus sowie die beiden Auflösungen 720p und 1080p.

<Tip>
  Dies ist eine **asynchrone** API und gibt nur die task\_id der asynchronen Aufgabe zurück. Verwenden Sie diese task\_id, um die [API zum Abfragen des Aufgabenergebnisses](/de/docs/models/reference-get-async-task-result) aufzurufen und das generierte Ergebnis abzurufen.
</Tip>

## Anfrageheader

<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>

## Anfragetext

<ParamField body="bgm" type="boolean" default={false}>
  Gibt an, ob Hintergrundmusik hinzugefügt werden soll
</ParamField>

<ParamField body="seed" type="integer">
  Zufalls-Seed zur Steuerung der Zufälligkeit des generierten Ergebnisses. Derselbe Seed erzeugt ähnliche Ergebnisse.
</ParamField>

<ParamField body="audio" type="boolean" default={false}>
  Gibt an, ob Audio generiert werden soll
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Text-Prompt; Platzhalter wie @1, @2 usw. können verwendet werden, um Subjekte zu referenzieren

  Mögliche Werte: `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`
</ParamField>

<ParamField body="duration" type="integer" required={true} default={5}>
  Videodauer (Sekunden), unterstützt 1–10 Sekunden

  Mögliche Werte: `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`
</ParamField>

<ParamField body="subjects" type="object[]" required={true}>
  Subjektliste; jedes Subjekt enthält name, images und voice\_id

  Array-Länge: 1 – unbegrenzt

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="name" type="string" required={true}>
      Subjektname; wird im prompt mit @{name} referenziert
    </ParamField>

    <ParamField body="images" type="string[]">
      Liste der Subjektbild-URLs, maximal 3 Bilder, jedes höchstens 20 MB

      Array-Länge: 0 - 3
    </ParamField>

    <ParamField body="voice_id" type="string">
      Sprach-ID, optional
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Gibt an, ob ein Wasserzeichen hinzugefügt werden soll
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  Auflösung des Ausgabevideos. Der Standardwert ist 720p.

  Mögliche Werte: `720p`, `1080p`
</ParamField>

<ParamField body="aspect_ratio" type="string">
  Seitenverhältnis des Videos, z. B. 16:9, 9:16, 1:1 usw.
</ParamField>

<ParamField body="movement_amplitude" type="string">
  Bewegungsamplitude; steuert die Bewegungsintensität von Objekten im Video

  Mögliche Werte: `auto`, `small`, `medium`, `high`
</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>