Referência da API
Guias de Integração
Preços e Faturamento
Wrapper do CometAPI
Geração Assíncrona de Vídeo
Gere vídeos Veo3 de forma assíncrona via POST /v1/videos no CometAPI, retornando um id de tarefa e oferecendo suporte a orientação por primeiro/último frame para clipes de 8 segundos.
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 um job do Veo pela rota compartilhada do CometAPI
/v1/videos. Escolha um alias atual do Veo na página de 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_referenceem ordem
Fluxo da tarefa
Envie o job do Veo
Envie um alias do Veo, Prompt e entradas de imagem opcionais, depois salve o
id retornado.Consulte a rota compartilhada de vídeo
Use Veo3 Retrieve para acompanhar a tarefa assíncrona até que ela alcance um estado terminal.
Resolução de alias
O Google documenta o Veo por meio das operações de vídeo de longa duração do Gemini e usa nomes de model comoveo-3.1-generate-preview. O CometAPI mantém a rota compartilhada /v1/videos e resolve um alias atual do Veo a partir da página de Models no momento da requisição. Durante a validação ao vivo em 2026-03-12, uma requisição com veo3-fast foi aceita e retornou um id de tarefa assíncrona, e o model da resposta foi resolvido para um id de model do provedor em vez de repetir o alias enviado.Autorizações
Bearer token authentication. Use your CometAPI key.
Corpo
multipart/form-data
Text prompt for the video job.
Exemplo:
"A paper kite floats above a field."
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"
Orientation hint used by the wrapper. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.
Exemplo:
"16x9"
Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.
⌘I
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"
}