Créer une vidéo Veo 3

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=veo3.1-fast \
  -F 'prompt=A paper kite floats above a field.' \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "veo3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Créez une vidéo Veo 3.1 à partir de texte ou d’une image. L’API renvoie immédiatement un ID de tâche. Enregistrez la valeur id renvoyée pour interroger la tâche et télécharger la vidéo terminée. POST /v1/videos utilise multipart/form-data. Envoyez les contrôles sous forme de champs de formulaire et une image sous forme de champ de fichier input_reference.

Choisir un modèle

ID de modèle	Quand l’utiliser	Remarques
`veo3.1-fast`	Choix par défaut pour la plupart des clips courts	Route Veo 3.1 plus rapide.
`veo3.1`	À utiliser lorsque vous souhaitez spécifiquement le modèle Veo 3.1 standard	Route Veo 3.1 standard.

Choisir un mode d’entrée

Objectif	Champs requis	Champs facultatifs
Texte vers vidéo	`model`, `prompt`	`seconds`, `size`
Image vers vidéo	`model`, `prompt`, un fichier image `input_reference`	`seconds`, `size`

Pour animer une image, importez un fichier via input_reference, en utilisant ce champ une seule fois. L’image définit l’image d’ouverture ; prompt décrit le mouvement et le comportement de caméra qui suivent.

Définir la durée et la taille

Pour cette route compatible avec OpenAI, définissez la durée avec une valeur entière explicite seconds et la taille de sortie avec size. Envoyez les deux valeurs sous forme de champs de formulaire.

ID de modèle	`seconds`	Par défaut
`veo3.1-fast`	`4`, `6`, `8`	`4` secondes, `1280x720`
`veo3.1`	`4`, `6`, `8`	`4` secondes, `1280x720`

Définissez size sur l’une des valeurs WxH ci-dessous.

Niveau de résolution	Format d’image	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
`4K`	`16:9`	`3840x2160`

Flux de tâche

Créer la tâche

Envoyez la requête de formulaire multipart et enregistrez la valeur id renvoyée.

Interroger la tâche

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

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<integer>

défaut:4

Requested clip duration in whole seconds. Send 4, 6, or 8 as a form field.

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

One image file that sets the opening frame for image-to-video. Send input_reference once with one file. Use prompt to describe the motion and camera behavior that follow.

Réponse

Task created. Store the returned id and poll GET /v1/videos/{task_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.

Dernière modification le 9 septembre 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=veo3.1-fast \
  -F 'prompt=A paper kite floats above a field.' \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "veo3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Modération de contenu

Clés API

Choisir un modèle

Choisir un mode d’entrée

Définir la durée et la taille

Flux de tâche

Autorisations

Corps

Réponse

​Choisir un modèle

​Choisir un mode d’entrée

​Définir la durée et la taille

​Flux de tâche

Autorisations

Corps

Réponse

Choisir un modèle

Choisir un mode d’entrée

Définir la durée et la taille

Flux de tâche