> ## 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 — Vidéo à partir d’une référence

API VIDU Q2 Pro Fast de conversion d’image/vidéo de référence en vidéo, prenant en charge le mode sujet et le mode sans sujet, avec deux résolutions disponibles : 720p et 1080p.

<Tip>
  Il s’agit d’une API **asynchrone** qui renvoie uniquement le task\_id de la tâche asynchrone. Vous devez utiliser ce task\_id pour appeler l’[API de requête du résultat de tâche](/fr/docs/models/reference-get-async-task-result) afin de récupérer le résultat généré.
</Tip>

## En-têtes de requête

<ParamField header="Content-Type" type="string" required={true}>
  Valeur énumérée : `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="bgm" type="boolean" default={false}>
  Indique s’il faut ajouter une musique de fond
</ParamField>

<ParamField body="seed" type="integer">
  Graine aléatoire utilisée pour contrôler le caractère aléatoire du résultat généré. Une même graine produit des résultats similaires.
</ParamField>

<ParamField body="audio" type="boolean" default={false}>
  Indique s’il faut générer de l’audio
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Prompt textuel, pouvant utiliser des espaces réservés tels que @1, @2 pour référencer les sujets

  Valeurs possibles : `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`
</ParamField>

<ParamField body="duration" type="integer" required={true} default={5}>
  Durée de la vidéo (en secondes), prend en charge 1 à 10 secondes

  Valeurs possibles : `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`
</ParamField>

<ParamField body="subjects" type="object[]" required={true}>
  Liste des sujets ; chaque sujet contient name, images et voice\_id

  Longueur du tableau : 1 - illimitée

  <Expandable title="propriétés" defaultOpen={true}>
    <ParamField body="name" type="string" required={true}>
      Nom du sujet, à référencer dans le prompt avec @{name}
    </ParamField>

    <ParamField body="images" type="string[]">
      Liste des URL d’images du sujet, jusqu’à 3 images, chacune ne dépassant pas 20 MB

      Longueur du tableau : 0 - 3
    </ParamField>

    <ParamField body="voice_id" type="string">
      ID de voix, facultatif
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Indique s’il faut ajouter un filigrane
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  Résolution de la vidéo de sortie. La valeur par défaut est 720p.

  Valeurs possibles : `720p`, `1080p`
</ParamField>

<ParamField body="aspect_ratio" type="string">
  Format d’image de la vidéo, par exemple 16:9, 9:16, 1:1, etc.
</ParamField>

<ParamField body="movement_amplitude" type="string">
  Amplitude du mouvement, contrôle l’intensité du mouvement des objets dans la vidéo

  Valeurs possibles : `auto`, `small`, `medium`, `high`
</ParamField>

## Informations de réponse

<ResponseField name="task_id" type="string" required={true}>
  Utilisez le task\_id pour appeler l’[API de requête du résultat de tâche](/fr/docs/models/reference-get-async-task-result) afin de récupérer la sortie générée.
</ResponseField>