Saltar para o conteúdo principal
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.

Use esta página para iniciar um job do Veo pela rota compartilhada do CometAPI /v1/videos. Escolha um alias atual do Veo na página Models ao definir model.

​
Escolha o padrão de requisição

  • Text-to-video: não envie arquivos input_reference
  • Image-to-video: envie um input_reference
  • Orientação por primeiro frame e último frame: envie dois arquivos input_reference em ordem

​
Fluxo da tarefa

1

Enviar o job do Veo

Envie um alias do Veo, um prompt e entradas de imagem opcionais, depois salve o id retornado.
2

Consultar o endpoint de vídeo compartilhado

Use Veo3 Retrieve para acompanhar a tarefa assíncrona até ela atingir um estado terminal.
3

Persistir o resultado

Mova o asset finalizado para o seu próprio armazenamento se a sua aplicação precisar de uma cópia durável.

​
Resolução de alias

O campo model na resposta pode mostrar o model id do backend resolvido em vez do alias que você enviou. Use a página Models para encontrar aliases atuais do Veo.

Autorizações

​
Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

multipart/form-data
​
prompt
string
obrigatório

Text prompt for the video job.

Exemplo:

"A paper kite floats above a field."

​
model
string
padrão: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.

Exemplo:

"veo3-fast"

​
size
string

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

Exemplo:

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

Resposta

200 - application/json

Task accepted.

​
created_at
integer
obrigatório
​
id
string
obrigatório
​
model
string
obrigatório

Provider model identifier resolved by CometAPI for this task.

​
object
string
obrigatório
​
progress
integer
obrigatório
​
seconds
string
obrigatório
​
size
string
obrigatório
​
status
string
obrigatório