Skip to main content
GET
Query Video Task Status

Get Task Status

Query the execution status of video generation tasks and retrieve generated videos when complete.

Endpoint

Authentication

All requests require Bearer token authentication:

Parameters

Path Parameters

Response

Success Response (200)

Response Fields

Status Values

Failed Task

Code Example

Important Notes

Poll Interval: Check status every 2-5 seconds. Typical video generation takes 90-300 seconds.
Content Validity: Generated videos are accessible for 3 days after creation. Download and save your content promptly.
Webhooks: Instead of polling, you can provide a callback_url when submitting tasks to receive automatic notifications. See Video Webhook Callbacks.
For code samples in more languages, polling with backoff, and HTTP error codes, see the unified task status page.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

task_id
string
required

Unique task identifier returned from the submit endpoint

Response

200 - application/json

Task status

code
integer
required
Example:

200

data
object
required
Example: