Get Veo Video
GET
/v1/videos/{task_id}Poll a Veo or Gemini Omni video task with the public task ID returned by the create endpoint. Completed tasks include a directly accessible signed video URL.
Polling and status values
Use the public task ID returned by the create endpoint. Poll every 5-10 seconds; a response without url simply means the task is not complete yet.
| Status | Meaning | Next action |
|---|---|---|
| queued | Accepted and waiting for capacity | Continue polling |
| in_progress | The provider is generating the video | Continue polling |
| completed | Generation succeeded; progress is 100 | Use url to access the MP4 |
| failed | Generation failed; error usually explains why | Correct the request and submit a new task |
Response fields
| Field | When present | Description |
|---|---|---|
| id | Always | Public task ID used for all future polling |
| status | Always | queued, in_progress, completed, or failed |
| progress | Always | Generation progress from 0 to 100 |
| url | completed only | Signed proxy URL for the generated video |
| error | failed usually | Provider or validation failure reason |
| model / size / seconds | When available | Effective output configuration |
| created_at / completed_at | When available | Unix timestamps in seconds |
Path Parameters
task_id:requiredstringPublic task ID returned in id by POST /v1/videos. Preserve the task_ prefix exactly; do not use or expose an upstream internal operation ID.
Example
task_FIeVpQgoAo5Dm4bx50ZjOxxjGhZYZjT8Header Parameters
Authorization:requiredstringBearer authentication header containing your API key.
Example
Bearer <YOUR_API_KEY>Response
200A successful request returns a JSON response. The complete example is shown in the code panel.