Vai al contenuto principale
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.

Usa questa pagina per avviare un job Veo tramite il percorso condiviso CometAPI /v1/videos. Scegli un alias Veo attuale dalla pagina Models quando imposti model.

​
Scegli il pattern di richiesta

  • Text-to-video: non inviare file input_reference
  • Image-to-video: invia un input_reference
  • Guida del primo frame e dell’ultimo frame: invia due file input_reference ordinati

​
Flusso del task

1

Invia il job Veo

Invia un alias Veo, un prompt e input immagine opzionali, quindi salva l’id restituito.
2

Esegui il polling dell'endpoint video condiviso

Usa Veo3 Retrieve per seguire il task async fino a quando non raggiunge uno stato terminale.
3

Salva il risultato

Sposta l’asset completato nel tuo storage se la tua applicazione ha bisogno di una copia persistente.

​
Risoluzione dell’alias

Il campo model nella risposta può mostrare l’id del modello backend risolto invece dell’alias che hai inviato. Usa la pagina Models per trovare gli alias Veo attuali.

Autorizzazioni

​
Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

multipart/form-data
​
prompt
string
obbligatorio

Text prompt for the video job.

Esempio:

"A paper kite floats above a field."

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

Esempio:

"veo3-fast"

​
size
string

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

Esempio:

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

Risposta

200 - application/json

Task accepted.

​
created_at
integer
obbligatorio
​
id
string
obbligatorio
​
model
string
obbligatorio

Provider model identifier resolved by CometAPI for this task.

​
object
string
obbligatorio
​
progress
integer
obbligatorio
​
seconds
string
obbligatorio
​
size
string
obbligatorio
​
status
string
obbligatorio