Retrieve Video

Use CometAPI Veo3 Retrieve API (GET /v1/videos/) to fetch status, query metadata, or download Veo3 video generation results by 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 this endpoint to poll a Veo job created through the CometAPI /v1/videos wrapper. It returns the current task state and the resolved backend model information CometAPI is using for the job.

Polling loop

1. Create the job first

   Start with Veo3 Async Generation and save the returned id.

2. Poll until the task is terminal

   Keep calling this endpoint until the job leaves queued or in_progress and reaches a finished state.

3. Store the result

   Once the output is ready, move it into your own storage if your application needs a durable copy.

Why the model name may change

Google’s official Veo workflow is still an async poll loop. CometAPI keeps that shape, but the response is normalized into the /v1/videos wrapper and may show the resolved backend model id rather than the alias you submitted.

Authorizations

Authorization · string · header · required

Bearer token authentication. Use your CometAPI key.

Path Parameters

video_id · string · required

Task id returned by the create endpoint.

Response

200 - application/json

Current job state.

id · string · required

size · string · required

model · string · required

object · string · required

status · string · required

progress · integer · required

created_at · integer · required

task_id · string