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

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.

Gebruik deze pagina om een Veo-job te starten via de gedeelde CometAPI-route /v1/videos. Kies een huidige Veo-alias op de Models-pagina bij het instellen van model.

​
Kies het request-patroon

  • Text-to-video: verstuur geen input_reference-bestanden
  • Image-to-video: verstuur één input_reference
  • First-frame and last-frame guidance: verstuur twee geordende input_reference-bestanden

​
Taskflow

1

Dien de Veo-job in

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

Poll het gedeelde video-endpoint

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

Sla het resultaat duurzaam op

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

​
Alias-omzetting

Het veld model in de response kan de opgeloste backend-model-id tonen in plaats van de alias die je hebt ingestuurd. Gebruik de Models-pagina om actuele Veo-aliassen te vinden.

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