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"
}
Use esta página para iniciar uma tarefa Veo pela rota compartilhada /v1/videos do CometAPI. Escolha um alias Veo atual na página Models ao definir model.

Escolha o padrão da requisição

  • Texto para vídeo: não envie arquivos input_reference
  • Imagem para vídeo: envie um input_reference
  • Orientação por primeiro frame e último frame: envie dois arquivos input_reference em ordem

Fluxo da tarefa

1

Envie a tarefa Veo

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

Consulte o endpoint de vídeo compartilhado

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

Armazene o resultado

Mova o asset concluído 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 id do modelo de backend resolvido em vez do alias que você enviou. Use a página Models para encontrar os aliases Veo atuais.

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 used by the wrapper. 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