> ## 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 image-vers-vidéo

<Info>
  L’API de la version Veo 3.1 Preview est automatiquement compatible avec cette interface
</Info>

Utilisez le modèle de génération vidéo Veo 3.1 pour générer du contenu vidéo de haute qualité à partir d’une image d’entrée et d’une description textuelle. Cette interface utilise un traitement asynchrone ; vous devez interroger le résultat final généré via le task\_id.

## En-têtes de requête

<ParamField header="Content-Type" type="string" required={true}>
  Valeur d’énumération : `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Format d’authentification Bearer : Bearer \{\{API Key}}.
</ParamField>

## Corps de la requête

<ParamField body="prompt" type="string" required={true}>
  Chaîne de texte décrivant la vidéo que vous souhaitez générer.
</ParamField>

<ParamField body="image" type="string" required={false}>
  Image d’entrée, prise en charge sous forme d’URL ou d’encodage base64.
</ParamField>

<ParamField body="last_image" type="string" required={false}>
  Image de fin, utilisée pour remplir la dernière image de la vidéo. Prise en charge sous forme d’URL ou d’encodage base64.
</ParamField>

<ParamField body="reference_images" type="object[]" required={false}>
  Liste de jusqu’à trois images `asset` ou jusqu’à une image `style`, utilisée pour décrire les images de référence que le modèle doit utiliser lors de la génération de la vidéo.

  <Expandable title="properties">
    <ParamField body="image" type="string" required={false}>
      Image de référence, prise en charge sous forme d’URL ou d’encodage base64.
    </ParamField>

    <ParamField body="reference_type" type="string" required={true}>
      Spécifie le type d’image de référence fourni. Valeurs prises en charge :

      * `asset` : l’image de référence fournit des éléments pour la vidéo générée, par exemple : scène, objet ou personnage.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="aspect_ratio" type="string" required={false}>
  Spécifie le rapport largeur/hauteur de la vidéo générée.

  Valeurs d’énumération : `16:9`, `9:16`. La valeur par défaut est `16:9`.
</ParamField>

<ParamField body="duration_seconds" type="integer" required={false}>
  Longueur du fichier vidéo que vous souhaitez générer (en secondes).

  Valeurs d’énumération : `4`, `6`, `8` ; lorsque `reference_images` est utilisé, seule la valeur `8` est possible.

  La valeur par défaut est `8`.
</ParamField>

<ParamField body="enhance_prompt" type="boolean" required={false}>
  Spécifie s’il faut utiliser Gemini pour améliorer votre prompt. Seule la valeur `true` est prise en charge.

  Valeur par défaut : `true`
</ParamField>

<ParamField body="generate_audio" type="boolean" required={true}>
  Spécifie s’il faut générer de l’audio pour la vidéo.
</ParamField>

<ParamField body="negative_prompt" type="string" required={false}>
  Chaîne de texte décrivant le contenu que vous souhaitez empêcher le modèle de générer.
</ParamField>

<ParamField body="person_generation" type="string" required={false}>
  Paramètre de sécurité qui contrôle l’autorisation de générer des personnes ou des visages.

  Valeurs d’énumération :

  * `allow_adult` (par défaut) : autorise uniquement la génération d’adultes
  * `dont_allow` : n’autorise pas la présence de personnes ou de visages dans l’image
  * `allow_all` : autorise la génération de personnes de tous âges (le projet doit être dans l’allowlist)
</ParamField>

<ParamField body="resolution" type="string" required={false}>
  Résolution de la vidéo générée.

  Valeurs d’énumération : `720p` (par défaut) ou `1080p`
</ParamField>

<ParamField body="sample_count" type="integer" required={false}>
  Nombre d’échantillons vidéo à générer.

  Plage de valeurs : 1-4
</ParamField>

<ParamField body="seed" type="uint32" required={false}>
  Nombre utilisé pour initialiser le processus de génération aléatoire. L’utilisation de la même graine, du même prompt et des autres mêmes paramètres produira la même vidéo de sortie, rendant le processus de génération déterministe.

  Plage de valeurs : 0-4,294,967,295
</ParamField>

## Paramètres des informations de réponse

<ResponseField name="task_id" type="string" required={true}>
  Le task\_id de la tâche asynchrone. Vous devez utiliser ce task\_id pour appeler l’[API de consultation du résultat de tâche](/fr/docs/models/reference-get-async-task-result) afin d’obtenir le résultat généré
</ResponseField>