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

# Veo 3.1 Bild-zu-Video

<Info>
  Die API der Veo 3.1 Preview-Version ist automatisch mit dieser Schnittstelle kompatibel.
</Info>

Verwenden Sie das Videogenerierungsmodell Veo 3.1, um durch Eingabe eines Bildes und einer Textbeschreibung hochwertige Videoinhalte zu erstellen. Diese Schnittstelle verarbeitet Anfragen asynchron; das endgültige Generierungsergebnis muss über die task\_id abgefragt werden.

## Anforderungsheader

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

## Anforderungstext

<ParamField body="prompt" type="string" required={true}>
  Eine Textzeichenfolge, die das Video beschreibt, das Sie generieren möchten.
</ParamField>

<ParamField body="image" type="string" required={false}>
  Eingabebild; unterstützt URL oder base64-kodierte Eingabe.
</ParamField>

<ParamField body="last_image" type="string" required={false}>
  Abschlussbild, das zum Füllen des letzten Frames des Videos verwendet wird. Unterstützt URL oder base64-kodierte Eingabe.
</ParamField>

<ParamField body="reference_images" type="object[]" required={false}>
  Eine Liste mit bis zu drei `asset`-Bildern oder bis zu einem `style`-Bild, die Referenzbilder beschreiben, die das Modell beim Generieren des Videos verwendet.

  <Expandable title="Eigenschaften">
    <ParamField body="image" type="string" required={false}>
      Referenzbild; unterstützt URL oder base64-kodierte Eingabe.
    </ParamField>

    <ParamField body="reference_type" type="string" required={true}>
      Gibt den Typ des bereitgestellten Referenzbildes an. Unterstützt die folgenden Werte:

      * `asset`: Das Referenzbild stellt Assets für das generierte Video bereit, z. B. Szenen, Objekte oder Charaktere.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="aspect_ratio" type="string" required={false}>
  Gibt das Seitenverhältnis des generierten Videos an.

  Enumerationswerte: `16:9`, `9:16`. Der Standardwert ist `16:9`.
</ParamField>

<ParamField body="duration_seconds" type="integer" required={false}>
  Die Länge der Videodatei, die Sie generieren möchten, in Sekunden.

  Enumerationswerte: `4`, `6`, `8`; bei Verwendung von `reference_images` ist nur `8` möglich.

  Der Standardwert ist `8`.
</ParamField>

<ParamField body="enhance_prompt" type="boolean" required={false}>
  Gibt an, ob Gemini verwendet werden soll, um Ihren Prompt zu verbessern. Es wird nur `true` unterstützt.

  Standardwert: `true`
</ParamField>

<ParamField body="generate_audio" type="boolean" required={true}>
  Gibt an, ob Audio für das Video generiert werden soll.
</ParamField>

<ParamField body="negative_prompt" type="string" required={false}>
  Eine Textzeichenfolge, die beschreibt, welche Inhalte das Modell nicht generieren soll.
</ParamField>

<ParamField body="person_generation" type="string" required={false}>
  Sicherheitseinstellung, die steuert, ob die Generierung von Personen oder Gesichtern erlaubt ist.

  Enumerationswerte:

  * `allow_adult` (Standard): Erlaubt nur die Generierung von Erwachsenen
  * `dont_allow`: Erlaubt keine Personen oder Gesichter im Bild
  * `allow_all`: Erlaubt die Generierung von Personen aller Altersgruppen (das Projekt muss in der allowlist enthalten sein)
</ParamField>

<ParamField body="resolution" type="string" required={false}>
  Die Auflösung des generierten Videos.

  Enumerationswerte: `720p` (Standard) oder `1080p`
</ParamField>

<ParamField body="sample_count" type="integer" required={false}>
  Die Anzahl der zu generierenden Videobeispiele.

  Wertebereich: 1-4
</ParamField>

<ParamField body="seed" type="uint32" required={false}>
  Eine Zahl zur Initialisierung des Zufallsgenerierungsprozesses. Die Verwendung desselben Seeds, Prompts und derselben anderen Parameter erzeugt dasselbe Ausgabevideo, wodurch der Generierungsprozess deterministisch wird.

  Wertebereich: 0-4,294,967,295
</ParamField>

## Antwortparameter

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