GEgenaipro
Veo V2

Get Task Status

Changed on

Poll the status of a video/image generation task. Use the task ID returned from any creation endpoint.

Status values

StatusDescription
processingTask is being processed
completedDone — file_urls contains the generated files
failedError — see error field for details. Credits are automatically refunded

Rate limit: 120 requests/minute per account, across all tasks. Polling many tasks? Prefer callback_url, the veo_v2_task_updated WebSocket event, or GET /v2/veo/histories (see Veo V2 → Getting results).

get/v2/veo/tasks/{id}

Request

Path parameters

idstring required

Task ID received from a creation endpoint

Response

Task status

idstring

Task ID

promptstring

The prompt used for generation

file_urlsstring[]

URLs of the generated files (empty while processing). Public; deleted about 90 days after creation (then 404) — download them yourself.

status'processing' | 'completed' | 'failed'

Task status

errorstring

Error message — present when status is failed, or when status is completed but some videos failed (see failed_slots)

modelstring

GTMage-2.5 tasks: gtmage-2.5, or <model>-<quality>-<resolution> for Sunburst / Flare (e.g. gtmage-2.5-sunburst-high-2k)

aspect_ratiostring

GTMage-2.5 tasks: the requested size

created_atstring date-time

Timestamp when the task was created

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "prompt": "A cat walking on the beach at sunset",
  "file_urls": []
}

Changes

  • 8e065c159192Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 031a52a1288bRevision changes
    • info

      added the optional property to the response with the status