Hopp til hovedinnhold
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"
}
Bruk denne siden til å starte en Veo-jobb via den delte CometAPI-ruten /v1/videos. Velg et gjeldende Veo-alias fra Models page når du setter model.

Velg request-mønsteret

  • Tekst-til-video: send ingen input_reference-filer
  • Bilde-til-video: send én input_reference
  • Første-bilde- og siste-bilde-veiledning: send to ordnede input_reference-filer

Task-flyt

1

Send inn Veo-jobben

Send et Veo-alias, prompt og valgfrie bildeinndata, og lagre deretter den returnerte id.
2

Poll det delte video-endepunktet

Bruk Veo3 Retrieve for å følge den asynkrone tasken til den når en terminal tilstand.
3

Lagre resultatet

Flytt den ferdige ressursen til din egen lagring hvis applikasjonen din trenger en varig kopi.

Alias-oppløsning

Google dokumenterer Veo gjennom Geminis langvarige videooperasjoner og bruker modellnavn som veo-3.1-generate-preview. CometAPI beholder den delte /v1/videos-ruten og løser et gjeldende Veo-alias fra Models page ved request-tid. Under live-validering 2026-03-12 ble en request med veo3-fast godtatt og returnerte en asynkron task id, og responsens model ble løst til en provider-modell-id i stedet for å gjengi det innsendte aliaset.

Autorisasjoner

Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Kropp

multipart/form-data
prompt
string
påkrevd

Text prompt for the video job.

Eksempel:

"A paper kite floats above a field."

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

Eksempel:

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

Eksempel:

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

Svar

200 - application/json

Task accepted.

created_at
integer
påkrevd
id
string
påkrevd
model
string
påkrevd

Provider model identifier resolved by CometAPI for this task.

object
string
påkrevd
progress
integer
påkrevd
seconds
string
påkrevd
size
string
påkrevd
status
string
påkrevd