> ## 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 multi-images intelligent

Générez une vidéo cohérente à partir de plusieurs images clés. Prend en charge trois résolutions : 540p, 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 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="wm_url" type="string">
  URL de l’image de filigrane. Lorsque le filigrane est activé mais qu’aucune URL de filigrane personnalisée n’est fournie, le filigrane par défaut est utilisé. Ce paramètre est sans effet si aucun filigrane n’est ajouté.
</ParamField>

<ParamField body="payload" type="string">
  Paramètre transmis tel quel. Aucune opération n’est effectuée ; il sert uniquement au transfert de données. Jusqu’à 1048576 caractères.
</ParamField>

<ParamField body="meta_data" type="string">
  Identifiant de métadonnées, sous forme de chaîne au format JSON. Champ transmis tel quel.
</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. La valeur par défaut est 720p.

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

<ParamField body="start_image" type="string" required={true}>
  Image de première frame. Prend en charge une image encodée en Base64 ou une URL d’image. Une seule image peut être fournie. Formats pris en charge : png, jpeg, jpg, webp. Le ratio de l’image doit être inférieur à 1:4 ou 4:1. La taille de l’image ne doit pas dépasser 50 MB.
</ParamField>

<ParamField body="wm_position" type="string" default="bottom_left">
  Position du filigrane. Par défaut : en bas à gauche. Ce paramètre est sans effet si aucun filigrane n’est ajouté.

  Valeurs possibles : `top_left`, `top_right`, `bottom_right`, `bottom_left`
</ParamField>

<ParamField body="image_settings" type="object[]" required={true}>
  Tableau de configuration des images clés ; chaque tâche doit contenir au minimum 2 images clés et au maximum 9 images clés.

  Longueur du tableau : 2 - 9

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="prompt" type="string">
      Prompt indiquant la manière de prolonger l’image précédente, utilisé pour contrôler le contenu de la vidéo prolongée.
    </ParamField>

    <ParamField body="duration" type="integer" default={5}>
      Durée multi-images. Durée de la vidéo entre différentes images clés. Par défaut : 5 s ; valeurs possibles : de 2 à 7 s.

      Plage de valeurs : \[2, 7]
    </ParamField>

    <ParamField body="key_image" type="string" required={true}>
      Image de référence de la frame intermédiaire. Le modèle utilisera l’image fournie dans ce paramètre comme frame finale pour générer la vidéo. Prend en charge une image encodée en Base64 ou une URL d’image. Une seule image peut être fournie. L’ordre d’entrée correspond à l’ordre de la chronologie (de la première frame à la dernière frame). Formats pris en charge : png, jpeg, jpg, webp. Le ratio de l’image doit être inférieur à 1:4 ou 4:1. La taille de l’image ne doit pas dépasser 50 MB.
    </ParamField>
  </Expandable>
</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>

<ResponseField name="provider_request_id" type="string" required={false}>
  ID de requête du fournisseur (facultatif)
</ResponseField>