Recuperar Vídeo

Use a API de Recuperação do CometAPI Veo3 (GET /v1/videos/) para buscar status, consultar metadados ou baixar resultados de geração de vídeo do Veo3 por video_id.

GET /v1/videos/{video_id}

Retrieve a Veo video job

cURL

curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "size": "16x9",
  "model": "veo_3_1-4K",
  "object": "video",
  "status": "queued",
  "task_id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "progress": 0,
  "created_at": 1773297229
}

Use este endpoint para consultar um job do Veo criado por meio do wrapper /v1/videos do CometAPI. Ele retorna o estado atual da tarefa e as informações resolvidas do modelo de backend que o CometAPI está usando para o job.

​

Loop de polling

1. Primeiro, crie o job

   Comece com Geração Assíncrona do Veo3 e salve o id retornado.

2. Faça polling até a tarefa chegar a um estado terminal

   Continue chamando este endpoint até que o job saia de queued ou in_progress e alcance um estado concluído.

3. Armazene o resultado

   Assim que a saída estiver pronta, mova-a para o seu próprio armazenamento se a sua aplicação precisar de uma cópia persistente.

​

Por que o nome do modelo pode mudar

O fluxo oficial do Veo do Google ainda é um loop assíncrono de polling. O CometAPI mantém esse formato, mas a resposta é normalizada no wrapper /v1/videos e pode mostrar o id do modelo de backend resolvido em vez do alias que você enviou.

Autorizações

Authorization · string · header · obrigatório

Bearer token authentication. Use your CometAPI key.

Parâmetros de caminho

video_id · string · obrigatório

Task id returned by the create endpoint.

Resposta

200 - application/json

Current job state.

id · string · obrigatório

size · string · obrigatório

model · string · obrigatório

object · string · obrigatório

status · string · obrigatório

progress · integer · obrigatório

created_at · integer · obrigatório

task_id · string