Skip to content

Get video task status

GET
/v1/videos/{task_id}
curl --request GET \
--url https://api.mirapi.ai/v1/videos/sora-2-123456 \
--header 'Authorization: Bearer <token>'

OpenAI-compatible endpoint for querying video task status.

Returns detailed status information for the video task.

task_id
required
string

Video task ID

Example
sora-2-123456

Video task status returned

Media typeapplication/json
object
id
required
string
object
required
string
model
required
string
status
required
string
progress
required
integer
created_at
required
integer
seconds
required
string
Example
{
"id": "sora-2-123456",
"object": "video",
"model": "sora-2",
"status": "queued",
"progress": 0,
"created_at": 1764347090922,
"seconds": "8"
}

Task not found

Media typeapplication/json
object
error
object
message

Error message

string
type

Error type

string
param

Related parameter

string
nullable
code

Error code

string
nullable
Examplegenerated
{
"error": {
"message": "example",
"type": "example",
"param": "example",
"code": "example"
}
}