> ## 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.

# Modèles de scène VIDU Q2

Générez une vidéo avec effets spéciaux à partir d’un modèle de scène et d’images d’entrée. Plusieurs modèles de scène sont pris en charge, avec des paramètres d’effets différents selon le modèle.

<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="bgm" type="boolean" default={false}>
  Indique s’il faut ajouter une musique de fond à la vidéo générée. Par défaut : false. Lorsque true est transmis, le système sélectionne automatiquement une musique adaptée dans la bibliothèque BGM prédéfinie et l’ajoute ; si le paramètre est omis ou défini sur false, aucune BGM n’est ajoutée. La durée de la BGM n’est pas limitée ; le système l’adapte automatiquement à la durée de la vidéo
</ParamField>

<ParamField body="area" type="string" default="auto">
  Paramètre spécifique à l’effet Princesse exotique. Disponible uniquement lorsque template vaut exotic\_princess. Par défaut : auto

  Valeurs possibles : `auto`, `denmark`, `uk`, `africa`, `china`, `mexico`, `switzerland`, `russia`, `italy`, `korea`, `thailand`, `india`, `japan`
</ParamField>

<ParamField body="seed" type="integer" default={0}>
  Graine aléatoire. Lorsqu’elle n’est pas transmise par défaut ou lorsqu’elle vaut 0, un nombre aléatoire est utilisé à la place ; si elle est définie manuellement, la graine spécifiée est utilisée
</ParamField>

<ParamField body="beast" type="string" default="auto">
  Paramètre spécifique à l’effet Compagnon animal. Disponible uniquement lorsque template vaut beast\_companion. Par défaut : auto

  Valeurs possibles : `auto`, `bear`, `tiger`, `elk`, `snake`, `lion`, `wolf`
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  Liste des images d’entrée. Le modèle utilisera les images transmises dans ce paramètre pour générer la vidéo. Prend en charge l’encodage Base64 d’image ou les URL d’image (assurez-vous qu’elles sont accessibles). Les formats d’image pris en charge sont png, jpeg, jpg et webp. Le ratio de l’image doit être inférieur à 1:4 ou 4:1, et la taille ne doit pas dépasser 50MB. La longueur en octets après décodage Base64 doit être inférieure à 10M, et l’encodage doit contenir la chaîne de type de contenu appropriée, par exemple : `data:image/png;base64,{base64_encode}`

  Longueur du tableau : 1 - illimitée
</ParamField>

<ParamField body="prompt" type="string">
  Prompt textuel, description textuelle de la vidéo à générer. Remarque : lorsque template=subject\_3 ou pubg\_winner\_hit, le prompt n’est pas obligatoire
</ParamField>

<ParamField body="wm_url" type="string">
  Contenu du filigrane, ici sous forme d’URL d’image. S’il n’est pas transmis, le filigrane par défaut est utilisé : contenu généré par l’IA
</ParamField>

<ParamField body="payload" type="string">
  Paramètre transmis tel quel, sans aucun traitement, uniquement pour le transfert de données. Maximum 1048576 caractères

  Limite de longueur : 0 - 1048576
</ParamField>

<ParamField body="template" type="string" required={true}>
  Paramètre de modèle de scène. Différents modèles de scène correspondent à différents paramètres d’appel. Modèles courants : subject\_3 (changement de tenue de personnage), pubg\_winner\_hit (effet spécial PUBG), exotic\_princess (princesse exotique), beast\_companion (compagnon animal), etc. Pour les modèles spécifiques, veuillez consulter : [https://platform.vidu.cn/docs/templates](https://platform.vidu.cn/docs/templates)
</ParamField>

<ParamField body="meta_data" type="string">
  Identifiant de métadonnées, chaîne au format json, champ transmis tel quel. Vous pouvez définir votre propre format ou utiliser le format d’exemple. Lorsque ce paramètre est vide, l’identifiant de métadonnées généré par vidu est utilisé par défaut. Format d’exemple : `{"Label": "your_label", "ContentProducer": "your_content_producer", "ContentPropagator": "your_content_propagator", "ProduceID": "your_product_id", "PropagateID": "your_propagate_id", "ReservedCode1": "your_reserved_code1", "ReservedCode2": "your_reserved_code2"}`
</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. Actuellement, le contenu du filigrane est fixe, généré par l’IA, et il n’est pas ajouté par défaut. Vous pouvez récupérer le contenu vidéo avec filigrane via le paramètre watermarked\_url
</ParamField>

<ParamField body="wm_position" type="integer" default={3}>
  Position du filigrane, indiquant l’emplacement du filigrane sur l’image. 1 : coin supérieur gauche ; 2 : coin supérieur droit ; 3 : coin inférieur droit ; 4 : coin inférieur gauche. La valeur par défaut est 3

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

<ParamField body="aspect_ratio" type="string" default="16:9">
  Ratio de la vidéo. Par défaut 16:9, valeurs possibles : 16:9, 9:16. Les valeurs possibles prises en charge varient selon le template ; consultez la description du modèle pour plus de détails

  Valeurs possibles : `16:9`, `9:16`
</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>

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