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"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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 de la définition 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, si besoin, des entrées image, puis enregistrez l’id renvoyé.
2

Interroger l’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 la ressource finalisée vers votre propre stockage si votre application a besoin d’une copie durable.

​
Résolution d’alias

Le champ model dans la réponse peut afficher l’id du modèle backend résolu plutôt que l’alias que vous avez soumis. Utilisez la page Models pour trouver les alias Veo actuels.

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