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

L’outil de conversion d’image en vidéo Vidu Q3 Pro transforme des images statiques en vidéos dynamiques, en conservant la cohérence du sujet tout en générant des mouvements naturels et des dynamiques de scène plus fluides.

<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 é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 une génération reproductible ; si la valeur est 0 ou omise, elle est générée aléatoirement

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

<ParamField body="audio" type="string">
  URL audio personnalisée pour la musique de fond de la vidéo ; prend en charge les formats mp3, wav, m4a, flac ; 20MB maximum
</ParamField>

<ParamField body="style" type="string" default="general">
  Style visuel de sortie ; general correspond à un style réaliste, anime à un style animé

  Valeurs possibles : `general`, `anime`
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  Tableau d’URL d’images de référence ; prend en charge `.jpg`, `.jpeg`, `.png`, `.webp`.
  Chaque image ne doit pas dépasser 50MB ; le ratio largeur/hauteur doit être compris entre 1:4 et 4:1.
  Actuellement, seule 1 image en entrée est prise en charge
</ParamField>

<ParamField body="is_rec" type="boolean" default={false}>
  Active la correspondance audio-vidéo ; lorsqu’il est défini sur true, le rythme audio est synchronisé avec la dynamique de la vidéo
</ParamField>

<ParamField body="prompt" type="string">
  Description du mouvement pour la génération vidéo ; décrit les mouvements de la scène, les actions et les effets dynamiques.

  Limite de longueur : 0 - 1500
</ParamField>

<ParamField body="wm_url" type="string">
  URL de l’image de filigrane personnalisée ; prend en charge les formats png, jpeg, jpg, webp ; 10MB maximum
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Durée de la vidéo (secondes)

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

<ParamField body="off_peak" type="boolean" default={false}>
  Utilise la tarification hors heures de pointe ; lorsqu’il est défini sur true, la tâche est mise en file d’attente pour être traitée hors heures de pointe afin de réduire les coûts
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Active le filigrane sur la vidéo de sortie
</ParamField>

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

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

<ParamField body="wm_position" type="string">
  Position du filigrane sur la vidéo

  Valeurs possibles : `top-left`, `top-right`, `bottom-left`, `bottom-right`
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  Ratio largeur/hauteur 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 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>