Skip to content

Get video task status ​

GET /v1/videos/{video_id}

Poll every 3–5 seconds using a customer key belonging to the task owner. Completed tasks can be downloaded via /content.

Guide and limits

Try this endpoint ​

Enter your API key and request parameters, then send. Generation requests are billed normally; authentication is not persisted in your browser.

Path and header parameters ​

NameInRequiredDescription
video_idpathyesID returned by the create operation.

Responses ​

StatusDescription
200Current status.
400Unsupported or conflicting parameters.
401Missing or invalid customer API Key.
404Task is not accessible.
429Capacity or rate limit exceeded.

application/json ​

json
{
  "id": "task_EXAMPLE",
  "object": "video",
  "status": "in_progress",
  "progress": 50,
  "created_at": 1790980000
}