Skip to main content
GET
Query any asynchronous task (video generation today) with the task ID returned when you submitted it.
string
required
The task ID returned when you submitted the request, for example task_01HXYZ.

Response fields

string
The task ID you submitted.
string
queued, in_progress, completed, or failed.
string
The model that ran the task.
number
0–100.
number
Unix timestamp (seconds) of submission.
number | null
Unix timestamp (seconds) of completion. null while running.
number
Amount billed in USD. Failed tasks are automatically refunded.
object | null
Present when status is completed. result.videos[].url is an array of direct download URLs (some models return more than one file); result.videos[].expires_at is the Unix timestamp when the URLs stop working.
object | null
error.message holds the failure reason when status is failed.
Result URLs expire (media is retained for 14 days — see expires_at). Download the files to your own storage promptly.
Poll every 10 to 20 seconds, or skip polling entirely with a webhook — the webhook payload is exactly this response object.