Query video task
Poll the status and result of a video generation task created via POST /v1/videos/generations.
Put the task_id returned from task creation in the request path. Tasks created through the historical POST /v1/video-generation endpoint can also be queried here.
Note: this endpoint’s envelope uses message, not msg as the create task endpoint does. Plan both field names when parsing.
file_url is dynamically signed. Download or copy the completed asset instead of treating the URL as a permanent identifier or long-lived cache key.
Recommended polling schedule
Video generation averages 2+ minutes. Use this schedule to balance responsiveness and request cost:
| Phase | Elapsed | Interval |
|---|---|---|
| Initial wait | 0 – 30s | — (no requests) |
| Medium | 30s – 2 min | every 5s |
| Dense | 2 – 4 min | every 3s (peak) |
| Slow | 4 – 8 min | every 8s |
| Idle | 8 – 15 min | every 15s |
| Timeout | > 15 min | stop, report error |
Stop polling when status is Success, Failed, or Cancelled.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Task id returned from a video generation create endpoint.
"aurora_abc123"