Passer au contenu principal
POST
/
v3
/
async
/
vidu-q2-template2video
Modèles de scène VIDU Q2
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-template2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "area": "<string>",
  "seed": 123,
  "beast": "<string>",
  "images": [
    {}
  ],
  "prompt": "<string>",
  "wm_url": "<string>",
  "payload": "<string>",
  "template": "<string>",
  "meta_data": "<string>",
  "watermark": true,
  "wm_position": 123,
  "aspect_ratio": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
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.
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 afin de récupérer le résultat généré.

​
En-têtes de requête

​
Content-Type
string
requis
Valeur énumérée : application/json
​
Authorization
string
requis
Format d’authentification Bearer : Bearer {{API Key}}.

​
Corps de la requête

​
bgm
boolean
défaut: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
​
area
string
défaut:"auto"
Paramètre spécifique à l’effet Princesse exotique. Disponible uniquement lorsque template vaut exotic_princess. Par défaut : autoValeurs possibles : auto, denmark, uk, africa, china, mexico, switzerland, russia, italy, korea, thailand, india, japan
​
seed
integer
défaut: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
​
beast
string
défaut:"auto"
Paramètre spécifique à l’effet Compagnon animal. Disponible uniquement lorsque template vaut beast_companion. Par défaut : autoValeurs possibles : auto, bear, tiger, elk, snake, lion, wolf
​
images
array
requis
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
​
prompt
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
​
wm_url
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
​
payload
string
Paramètre transmis tel quel, sans aucun traitement, uniquement pour le transfert de données. Maximum 1048576 caractèresLimite de longueur : 0 - 1048576
​
template
string
requis
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
​
meta_data
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"}
​
watermark
boolean
défaut: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
​
wm_position
integer
défaut: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 3Valeurs possibles : 1, 2, 3, 4
​
aspect_ratio
string
défaut:"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étailsValeurs possibles : 16:9, 9:16

​
Informations de réponse

​
task_id
string
requis
Utilisez task_id pour appeler l’API de consultation du résultat de tâche afin de récupérer la sortie générée.
​
provider_request_id
string
ID de requête du fournisseur (facultatif)