Passer au contenu principal
POST
/
v3
/
async
/
vidu-q3-pro-i2v
Vidu Q3 Pro Image vers vidéo
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q3-pro-i2v \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "seed": 123,
  "audio": "<string>",
  "style": "<string>",
  "images": [
    {}
  ],
  "is_rec": true,
  "prompt": "<string>",
  "wm_url": "<string>",
  "duration": 123,
  "off_peak": true,
  "watermark": true,
  "resolution": "<string>",
  "wm_position": "<string>",
  "aspect_ratio": "<string>"
}
'
{
  "task_id": "<string>"
}
L’outil de conversion d’image en vidéo Vidu Q3 Pro transforme des images statiques en vidéos dynamiques, en conservant la cohérence du sujet tout en générant des mouvements naturels et des dynamiques de scène plus fluides.
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

​
seed
integer
Graine aléatoire, utilisée pour une génération reproductible ; si la valeur est 0 ou omise, elle est générée aléatoirementPlage de valeurs : [0, 2147483647]
​
audio
string
URL audio personnalisée pour la musique de fond de la vidéo ; prend en charge les formats mp3, wav, m4a, flac ; 20MB maximum
​
style
string
défaut:"general"
Style visuel de sortie ; general correspond à un style réaliste, anime à un style animéValeurs possibles : general, anime
​
images
array
requis
Tableau d’URL d’images de référence ; prend en charge .jpg, .jpeg, .png, .webp. Chaque image ne doit pas dépasser 50MB ; le ratio largeur/hauteur doit être compris entre 1:4 et 4:1. Actuellement, seule 1 image en entrée est prise en charge
​
is_rec
boolean
défaut:false
Active la correspondance audio-vidéo ; lorsqu’il est défini sur true, le rythme audio est synchronisé avec la dynamique de la vidéo
​
prompt
string
Description du mouvement pour la génération vidéo ; décrit les mouvements de la scène, les actions et les effets dynamiques.Limite de longueur : 0 - 1500
​
wm_url
string
URL de l’image de filigrane personnalisée ; prend en charge les formats png, jpeg, jpg, webp ; 10MB maximum
​
duration
integer
défaut:5
Durée de la vidéo (secondes)Plage de valeurs : [1, 16]
​
off_peak
boolean
défaut:false
Utilise la tarification hors heures de pointe ; lorsqu’il est défini sur true, la tâche est mise en file d’attente pour être traitée hors heures de pointe afin de réduire les coûts
​
watermark
boolean
défaut:false
Active le filigrane sur la vidéo de sortie
​
resolution
string
défaut:"720p"
Résolution de sortie de la vidéoValeurs possibles : 540p, 720p, 1080p
​
wm_position
string
Position du filigrane sur la vidéoValeurs possibles : top-left, top-right, bottom-left, bottom-right
​
aspect_ratio
string
défaut:"16:9"
Ratio largeur/hauteur de la vidéo de sortieValeurs possibles : 16:9, 9:16, 4:3, 3:4, 1:1

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