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 gjennom den delte CometAPI-ruten /v1/videos. Velg et gjeldende Veo-alias fra Models page når du setter model.

Velg forespørselsmønsteret

  • Tekst-til-video: send ingen input_reference-filer
  • Bilde-til-video: send én input_reference
  • Veiledning med første og siste bilde: 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 videoendepunktet

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

Lagre resultatet

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

Aliasoppløsning

model-feltet i responsen kan vise den løste backend-modell-id-en i stedet for aliaset du sendte inn. Bruk Models page for å finne gjeldende Veo-alias.

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