v1

latestOpenAPI 3.1.02026-07-224941145.6 KB

Query Video Task Status

Query the status and details of a Sora 2 video generation task.

get/v1/videos/{id}

Path parameters

idstring required

Video task ID returned from the create endpoint.

Response

Task status

idstring

objectstring

modelstring

status'queued' | 'in_progress' | 'completed' | 'failed'

progressinteger

promptstring

secondsstring

sizestring

created_atinteger

completed_atinteger nullable

expires_atinteger nullable

errorstring nullable

remixed_from_video_idstring nullable

Example response

{
  "id": "video_69b131ea03548190925a6a06febf993b",
  "object": "video",
  "model": "sora-2",
  "status": "in_progress",
  "prompt": "A cat walking through a sunflower field",
  "seconds": "12",
  "size": "1280x720",
  "created_at": 1773220330
}