Passer au contenu principal
POST
/
v3
/
async
/
vidu-2.0-reference2video
Vidéo à partir de références Vidu 2.0
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-2.0-reference2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "images": [
    "<string>"
  ],
  "prompt": "<string>",
  "duration": 123,
  "seed": 123,
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "movement_amplitude": "<string>",
  "bgm": true
}
'
{
  "task_id": "<string>"
}
La vidéo à partir de références Vidu 2.0 génère des vidéos à l’aide d’images de référence et de descriptions textuelles. Elle prend en charge différents types de sujets, comme des personnages et des objets. En téléchargeant plusieurs angles de vue du sujet, vous pouvez créer des vidéos qui conservent une cohérence visuelle.
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 de génération vidéo.

​
En-têtes de requête

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

​
Corps de la requête

​
images
string[]
requis
Le modèle utilisera les images fournies comme références pour générer une vidéo avec un sujet cohérent.Exigences relatives au champ d’image :
  • Accepte de 1 à 3 images
  • Les ressources d’image peuvent être fournies via une URL ou un encodage Base64
  • L’un des formats suivants doit être utilisé : PNG, JPEG, JPG, WebP
  • Les dimensions de l’image doivent être d’au moins 128x128 pixels
  • Le rapport largeur/hauteur de l’image doit être inférieur à 1:4 ou 4:1
  • Toutes les images sont limitées à 50MB
  • La longueur après décodage base64 doit être inférieure à 10MB et doit inclure une chaîne de type de contenu appropriée. Par exemple :
data:image/png;base64,{base64_encode}
​
prompt
string
requis
Prompt textuel pour la génération vidéo, d’une longueur maximale de 1500 caractères.
​
duration
integer
Durée de la vidéo (en secondes). Par défaut : 4 secondes. Option : 4.
​
seed
integer
Graine aléatoire pour la génération vidéo.
  • Par défaut, une valeur de graine aléatoire est utilisée
  • Une valeur définie manuellement remplacera la graine aléatoire par défaut
​
aspect_ratio
string
Rapport largeur/hauteur de la vidéo de sortie. Valeur par défaut : 16:9
Valeurs possibles : 16:9, 9:16, 1:1
​
resolution
string
Le paramètre de résolution est par défaut 360p ; les options disponibles sont 360p et 720p.
​
movement_amplitude
string
Amplitude du mouvement des objets dans l’image. Valeur par défaut : auto
Valeurs possibles : auto, small, medium, large
​
bgm
boolean
Indique s’il faut ajouter une musique de fond à la vidéo générée. Valeur par défaut : false
Valeurs possibles : true, falseLorsque ce paramètre est défini sur true, le système ajoute automatiquement une BGM appropriée. La BGM n’a pas de limite de durée ; le système l’adapte automatiquement.

​
Informations de réponse

​
task_id
string
requis
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 d’obtenir le résultat généré.