Skip to main content
POST
cURL
Utilisez ce point de terminaison pour démarrer une tâche vidéo Veo 3.1. L’API renvoie immédiatement un ID de tâche ; stockez donc l’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, utilisez seconds pour la durée et size pour la taille de sortie. Envoyez les valeurs comme champs de formulaire. Définissez size sur l’une des valeurs WxH ci-dessous.

Flux de tâche

1

Créer la tâche

Envoyez la requête de formulaire multipart et stockez l’id retourné.
2

Interroger la tâche

Utilisez Veo3 Retrieve jusqu’à ce que status soit completed, failed ou error.
3

Télécharger le résultat

Lorsque la tâche est completed, téléchargez le fichier MP4 depuis la réponse de tâche terminée.

Autorisations

Authorization
string
header
requis

Bearer authentication. Use your CometAPI API key.

Corps

multipart/form-data
model
enum<string>
requis

Veo 3.1 model ID. Use veo3.1-fast for the default route or veo3.1 when you specifically need the standard model.

Options disponibles:
veo3.1-fast,
veo3.1
Exemple:

"veo3.1-fast"

prompt
string
requis

Text prompt for the video job.

Exemple:

"A paper kite floats above a field."

seconds
enum<string>
défaut:4

Requested clip duration. Use 4, 6, or 8. Send the value as a form field string.

Options disponibles:
4,
6,
8
Exemple:

"4"

size
string

Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.

Exemple:

"1280x720"

input_reference
file

Optional first-frame image file for image-to-video.

Réponse

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

id
string
requis

Task ID. Use this value with retrieve and content endpoints.

Exemple:

"task_example"

object
string
requis

Object type. Video tasks return video.

Exemple:

"video"

model
string
requis

Model ID used for the task.

Exemple:

"veo3.1-fast"

status
enum<string>
requis

Task lifecycle status. Poll until the value is completed, failed, or error.

Options disponibles:
queued,
in_progress,
completed,
failed,
error
Exemple:

"queued"

progress
integer
requis

Task progress as a coarse percentage.

Plage requise: 0 <= x <= 100
Exemple:

0

created_at
integer
requis

Task creation time as a Unix timestamp in seconds.

Exemple:

1779938152

task_id
string

Compatibility alias for id when present.

Exemple:

"task_example"

completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Exemple:

1779938219

video_url
string

Temporary video delivery URL. This field appears on completed tasks.

Exemple:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.