Passer au contenu principal
POST
/
v3
/
async
/
vidu-q1-reference2video
Vidéo à partir de références Vidu Q1
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q1-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>"
}
Vidu Q1 Vidéo à partir de références génère des vidéos à partir d’images de référence et de descriptions textuelles. Il prend en charge divers sujets, tels que des personnages et des objets. En téléversant plusieurs angles d’un 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 requête 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
Valeurs 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 du champ image :
  • Accepte de 1 à 7 images
  • Les ressources d’image peuvent être fournies via URL ou 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 contenir la 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). La valeur par défaut est de 5 secondes ; actuellement, seule l’option 5 secondes est prise en charge.
seed
integer
Graine aléatoire pour la génération vidéo.
  • La valeur par défaut est une graine aléatoire
  • 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 optionnelles : 16:9, 9:16, 1:1
resolution
string
Résolution de la vidéo de sortie. La valeur par défaut est 1080p ; actuellement, seule l’option 1080p est prise en charge.
movement_amplitude
string
Amplitude du mouvement des objets dans l’image. Valeur par défaut : auto
Valeurs optionnelles : 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 optionnelles : true, false
Lorsque défini sur true, le système ajoutera automatiquement une BGM appropriée. La BGM n’a pas de limite de durée ; le système l’adaptera 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 requête du résultat de tâche afin d’obtenir le résultat généré