Créer une vidéo Veo 3
Générez des vidéos Veo 3.1 de manière asynchrone via CometAPI avec POST /v1/videos, puis interrogez la tâche et téléchargez le fichier MP4 terminé.
id retourné 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 et les entrées multimédias comme champs de fichier input_reference.
Choisir un modèle
Choisir un mode d’entrée
Définir la durée et la taille
Pour la route compatible OpenAI, utilisezseconds pour la durée et size pour la taille de sortie. Envoyez les valeurs comme champs de formulaire.
size sur l’une des valeurs WxH ci-dessous.
Flux de tâche
Créer la tâche
id retourné.Interroger la tâche
status soit completed, failed ou error.Télécharger le résultat
completed, téléchargez le fichier MP4 depuis la réponse de tâche terminée.Autorisations
Bearer authentication. Use your CometAPI API key.
Corps
Veo 3.1 model ID. Use veo3.1-fast for the default route or veo3.1 when you specifically need the standard model.
veo3.1-fast, veo3.1 "veo3.1-fast"
Text prompt for the video job.
"A paper kite floats above a field."
Requested clip duration. Use 4, 6, or 8. Send the value as a form field string.
4, 6, 8 "4"
Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.
"1280x720"
Optional first-frame image file for image-to-video.
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.
"veo3.1-fast"
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.