Créer une vidéo Vidu
Créez une tâche Vidu Q3 de conversion texte-vers-vidéo via CometAPI avec POST /v1/videos, puis interrogez la tâche et téléchargez le fichier MP4 terminé.
id renvoyé et interrogez la tâche jusqu’à ce qu’elle atteigne un statut terminal.
POST /v1/videos utilise multipart/form-data ; transmettez les contrôles scalaires comme champs de formulaire.
Choisir un modèle
Définir la durée et la taille
size sur l’une des valeurs WxH ci-dessous.
Flux de la tâche
Créer la tâche
id renvoyé.Interroger la tâche
status soit completed, failed ou error.Télécharger le résultat
completed, appelez Récupérer le contenu de la vidéo Vidu pour télécharger le fichier MP4.Autorisations
Bearer authentication. Use your CometAPI API key.
Corps
Vidu Q3 model ID for this endpoint.
viduq3-turbo, viduq3 "viduq3-turbo"
Text prompt that describes the video to generate.
"An astronaut walks through soft blue fog with a slow cinematic camera move."
Requested clip duration in seconds. Use an integer from 1 through 16. Default is 5.
"1"
Supported WxH size values: 640x352, 960x528, 1280x720, 1920x1080. Default is 1280x720.
Réponse
Task created. Store the returned id and poll GET /v1/videos/{task_id}.
Task ID. Use this value with retrieve and content endpoints.
"task_example"
Object type. Video tasks return video.
"video"
Model ID used for the task.
"viduq3-turbo"
Task lifecycle status. Poll until the value is completed, failed, or error.
queued, in_progress, completed, failed, error "queued"
Task progress as a coarse percentage.
0 <= x <= 1000
Task creation time as a Unix timestamp in seconds.
1779938152
Compatibility alias for id when present.
"task_example"
Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.
1779938219
Temporary video delivery URL. This field appears on completed tasks.
"<temporary-video-url>"
Failure details. This field appears when the task fails.