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

Vidu Q3 Turbo texte-vers-vidéo peut générer des vidéos de haute qualité avec audio synchronisé à partir de descriptions textuelles, avec une résolution jusqu’à 1080p et une durée de 1 à 16 secondes.

<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 avec l’[API de consultation du résultat de tâche](/fr/docs/models/reference-get-async-task-result) pour 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="seed" type="integer">
  Graine aléatoire, utilisée pour rendre les résultats reproductibles. Si elle n’est pas fournie ou si elle vaut 0, un nombre aléatoire est utilisé.

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

<ParamField body="audio" type="boolean" default={true}>
  Indique s’il faut utiliser la capacité de sortie audiovisuelle directe (incluant les dialogues et les effets sonores). false : sortie vidéo muette ; true : sortie vidéo avec son. Ce paramètre est uniquement pris en charge par les modèles de la série Q3.
</ParamField>

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

  Limite de longueur : 0 - 5000
</ParamField>

<ParamField body="wm_url" type="string">
  URL de l’image de contenu du filigrane. Si elle n’est pas fournie, le filigrane par défaut est utilisé (contenu généré par l’IA).
</ParamField>

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

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

<ParamField body="off_peak" type="boolean" default={false}>
  Mode heures creuses. true : générer la vidéo en mode heures creuses, avec une consommation de crédits réduite, la tâche étant générée sous 48 heures ; false : générer la vidéo immédiatement.
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Indique s’il faut ajouter un filigrane. true : ajouter un filigrane ; false : ne pas ajouter de filigrane. Par défaut, aucun filigrane n’est ajouté.
</ParamField>

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

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

<ParamField body="wm_position" type="integer" default={3}>
  Position du filigrane : 1=coin supérieur gauche, 2=coin supérieur droit, 3=coin inférieur droit, 4=coin inférieur gauche. Par défaut 3 (coin inférieur droit).

  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 task\_id avec l’[API de consultation du résultat de tâche](/fr/docs/models/reference-get-async-task-result) pour récupérer la sortie générée.
</ResponseField>