Passer au contenu principal
POST
/
v3
/
async
/
vidu-q3-pro-t2v
Vidu Q3 Pro – texte vers vidéo
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q3-pro-t2v \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "seed": 123,
  "audio": true,
  "prompt": "<string>",
  "wm_url": "<string>",
  "duration": 123,
  "off_peak": true,
  "watermark": true,
  "resolution": "<string>",
  "wm_position": 123,
  "aspect_ratio": "<string>"
}
'
{
  "task_id": "<string>"
}
Il s’agit d’une API asynchrone qui renvoie uniquement le task_id de la tâche asynchrone.
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 d’énumération : 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 rendre les résultats reproductibles. Utilisez 0 pour une valeur aléatoire.Plage de valeurs : [0, 2147483647]
​
audio
boolean
défaut:true
Indique s’il faut utiliser la génération directe audio-vidéo (incluant les répliques et les effets sonores). Seul le modèle Q3 prend en charge ce paramètre.
​
prompt
string
requis
Description textuelle pour la génération vidéo, jusqu’à 2000 caractères.Limite de longueur : 0 - 2000
​
wm_url
string
URL de l’image de filigrane.
​
duration
integer
défaut:5
Durée de la vidéo (en secondes), plage 1-16.Plage de valeurs : [1, 16]
​
off_peak
boolean
défaut:false
Utiliser le mode heures creuses. La tâche sera traitée dans les 48 heures, à un coût réduit.
​
watermark
boolean
défaut:false
Indique s’il faut ajouter un filigrane.
​
resolution
string
défaut:"720p"
Qualité de la vidéo de sortie.Valeurs possibles : 540p, 720p, 1080p
​
wm_position
integer
Position du filigrane : 1=en haut à gauche, 2=en haut à droite, 3=en bas à gauche, 4=en bas à droite.Plage de valeurs : [1, 4]
​
aspect_ratio
string
défaut:"16:9"
Format d’image de la vidéo de sortie.Valeurs possibles : 16:9, 9:16, 4:3, 3:4, 1:1

​
Informations de réponse

​
task_id
string
requis
Utilisez le 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.