Task Management
Get task status
One endpoint to check any asynchronous generation task by its ID.
GET
Query any asynchronous task (video generation today) with the task ID returned
when you submitted it.
Poll every 10 to 20 seconds, or skip polling entirely with a
webhook — the webhook payload is exactly this
response object.
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.