Génération vidéo asynchrone

Générez des vidéos Veo3 de manière asynchrone via POST /v1/videos dans CometAPI, avec retour d’un id de tâche et prise en charge du guidage par première/dernière image pour des clips de 8 secondes.

POST /v1/videos

Create a Veo video job

cURL

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'

200

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