> ## 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 Q3 Pro – texte vers vidéo

Il s’agit d’une API asynchrone qui renvoie uniquement le `task_id` de la tâche asynchrone.

<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 consultation 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 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="seed" type="integer">
  Graine aléatoire, utilisée pour rendre les résultats reproductibles. Utilisez 0 pour une valeur aléatoire.

  Plage de valeurs : \[0, 2147483647]
</ParamField>

<ParamField body="audio" type="boolean" default={true}>
  Indique s’il faut utiliser la génération directe audio-vidéo (incluant les répliques et les effets sonores). Seul le modèle Q3 prend en charge ce paramètre.
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Description textuelle pour la génération vidéo, jusqu’à 2000 caractères.

  Limite de longueur : 0 - 2000
</ParamField>

<ParamField body="wm_url" type="string">
  URL de l’image de filigrane.
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Durée de la vidéo (en secondes), plage 1-16.

  Plage de valeurs : \[1, 16]
</ParamField>

<ParamField body="off_peak" type="boolean" default={false}>
  Utiliser le mode heures creuses. La tâche sera traitée dans les 48 heures, à un coût réduit.
</ParamField>

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

<ParamField body="resolution" type="string" default="720p">
  Qualité de la vidéo de sortie.

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

<ParamField body="wm_position" type="integer">
  Position du filigrane : 1=en haut à gauche, 2=en haut à droite, 3=en bas à gauche, 4=en bas à droite.

  Plage de valeurs : \[1, 4]
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  Format d’image de la vidéo de sortie.

  Valeurs possibles : `16:9`, `9:16`, `4:3`, `3:4`, `1:1`
</ParamField>

## Informations de réponse

<ResponseField name="task_id" type="string" required={true}>
  Utilisez le task\_id pour appeler l’[API de consultation 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>