> ## 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 Text-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 anhand von Textbeschreibungen hochwertige Videoinhalte zu generieren. Diese Schnittstelle verarbeitet Anfragen asynchron; das endgültige Generierungsergebnis muss über die task\_id abgefragt werden.

## 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="prompt" type="string" required={true}>
  Eine Textzeichenfolge, die das Video beschreibt, das Sie generieren möchten.
</ParamField>

<ParamField body="aspect_ratio" type="string" required={false}>
  Gibt das Seitenverhältnis des zu generierenden 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`. 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 zur Steuerung, 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 (Projekt muss sich in der allowlist befinden)
</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 Videos.

  Wertebereich: 1-4
</ParamField>

<ParamField body="seed" type="uint32" required={false}>
  Eine Zahl zur Initialisierung des zufälligen Generierungsprozesses. Die Verwendung desselben Seeds, Prompts und derselben sonstigen Parameter führt zum selben 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. Sie sollten diese task\_id verwenden, um die [API zum Abfragen des Aufgabenergebnisses](/de/docs/models/reference-get-async-task-result) aufzurufen und das Generierungsergebnis zu erhalten
</ResponseField>