Skip to main content
GET
Get video task status

Polling and status

Replace <TASK_ID> with the returned id and poll every 10 to 15 seconds:
After success, download the video.

Failures and retries

A failed task is a generation failure even with HTTP 200. After a polling disconnect, retry with the same id. Correct parameter errors before retrying a 400. Files remain for 72 hours and task records for 7 days. After a 429 or temporary service error, wait before retrying the read; do not create another task. If a task is missing, check the identifier and the account that owns the API key.

Authorizations

Authorization
string
header
required

API key (sk-xxx)

Path Parameters

task_id
string
required

Video task ID

Response

Video task status retrieved successfully

id
string
required
object
string
required
model
string
required
status
string
required
progress
integer
required
created_at
integer
required
seconds
string
required
error
object

OpenAI video error information