Naar hoofdinhoud gaan
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"
}
Gebruik deze pagina om een Veo-job te starten via de gedeelde CometAPI-route /v1/videos. Kies een actuele Veo-alias op de Models-pagina wanneer je model instelt.

Kies het request-patroon

  • Tekst-naar-video: verstuur geen input_reference-bestanden
  • Afbeelding-naar-video: verstuur één input_reference
  • First-frame en last-frame guidance: verstuur twee geordende input_reference-bestanden

Taskflow

1

Dien de Veo-job in

Verstuur een Veo-alias, prompt en optionele afbeeldingsinvoer, en sla vervolgens het geretourneerde id op.
2

Poll het gedeelde video-endpoint

Gebruik Veo3 Retrieve om de async task te volgen totdat deze een eindstatus bereikt.
3

Sla het resultaat op

Verplaats het voltooide bestand naar je eigen opslag als je applicatie een duurzame kopie nodig heeft.

Aliasresolutie

Google documenteert Veo via de long-running video operations van Gemini en gebruikt modelnamen zoals veo-3.1-generate-preview. CometAPI behoudt de gedeelde route /v1/videos en resolveert tijdens de request een actuele Veo-alias vanaf de Models-pagina. Tijdens live validatie op 2026-03-12 werd een request met veo3-fast geaccepteerd en werd een async task id geretourneerd, en de response model resolveerde naar een provider-model-id in plaats van de ingediende alias terug te geven.

Autorisaties

Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Body

multipart/form-data
prompt
string
vereist

Text prompt for the video job.

Voorbeeld:

"A paper kite floats above a field."

model
string
standaard: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.

Voorbeeld:

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

Voorbeeld:

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

Respons

200 - application/json

Task accepted.

created_at
integer
vereist
id
string
vereist
model
string
vereist

Provider model identifier resolved by CometAPI for this task.

object
string
vereist
progress
integer
vereist
seconds
string
vereist
size
string
vereist
status
string
vereist