Passer au contenu principal
POST
/
v1
/
videos
Create a Veo video job
curl --request POST \
  --url https://api.cometapi.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=A paper kite floats above a field.' \
  --form input_reference='@example-file'
{
  "created_at": 1773297229,
  "id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "model": "veo_3_1-4K",
  "object": "video",
  "progress": 0,
  "seconds": "",
  "size": "16x9",
  "status": "queued"
}
Utilisez cette page pour démarrer une tâche Veo via la route partagée CometAPI /v1/videos. Choisissez un alias Veo actuel depuis la page Models lors du paramétrage de model.

Choisir le modèle de requête

  • Texte vers vidéo : n’envoyez aucun fichier input_reference
  • Image vers vidéo : envoyez un input_reference
  • Guidage par première image et dernière image : envoyez deux fichiers input_reference ordonnés

Flux de tâche

1

Soumettre la tâche Veo

Envoyez un alias Veo, un prompt et des entrées d’image facultatives, puis enregistrez l’id renvoyé.
2

Interroger le endpoint vidéo partagé

Utilisez Veo3 Retrieve pour suivre la tâche asynchrone jusqu’à ce qu’elle atteigne un état terminal.
3

Conserver le résultat

Déplacez l’asset finalisé vers votre propre stockage si votre application a besoin d’une copie durable.

Résolution des alias

Google documente Veo via les opérations vidéo longue durée de Gemini et utilise des noms de modèle comme veo-3.1-generate-preview. CometAPI conserve la route partagée /v1/videos et résout un alias Veo actuel depuis la page Models au moment de la requête. Lors d’une validation en conditions réelles le 2026-03-12, une requête avec veo3-fast a été acceptée et a renvoyé un id de tâche asynchrone, et le model de la réponse a été résolu vers un id de modèle fournisseur au lieu de reprendre l’alias soumis.

Autorisations

Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

multipart/form-data
prompt
string
requis

Text prompt for the video job.

Exemple:

"A paper kite floats above a field."

model
string
défaut:veo3-fast

CometAPI Veo alias. Use a current Veo alias from the Models page. The response may resolve this alias to a provider model id.

Exemple:

"veo3-fast"

size
string

Orientation hint used by the wrapper. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.

Exemple:

"16x9"

input_reference
file

Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.

Réponse

200 - application/json

Task accepted.

created_at
integer
requis
id
string
requis
model
string
requis

Provider model identifier resolved by CometAPI for this task.

object
string
requis
progress
integer
requis
seconds
string
requis
size
string
requis
status
string
requis