Skip to main content
GET
/
v1
/
video
/
generations
/
{task_id}
Get video generation task status
curl --request GET \
  --url https://api.getinfinityblue.com/v1/video/generations/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "task_id": "abcd1234efgh",
  "status": "in_progress"
}

​
Task status values

StatusMeaning
queuedWaiting in queue
in_progressGeneration in progress
completedDone — download the video from url
failedGeneration failed — check the error field

​
Polling guidance

Tasks typically complete in 30 seconds to a few minutes depending on the model and video length. Poll every 5–10 seconds and set a reasonable timeout (e.g. 10 minutes).

Authorizations

​
Authorization
string
header
required

Bearer token authentication, format: Authorization: Bearer sk-xxxxxx. Get your API key in the console.

Path Parameters

​
task_id
string
required

Task ID returned by the create endpoint.

Response

Task status retrieved successfully

Status response for a generic video generation task.

​
task_id
string

Task ID.

Example:

"abcd1234efgh"

​
status
enum<string>

Task status.

Available options:
queued,
in_progress,
completed,
failed
Example:

"completed"

​
url
string

Video file URL, populated when status=completed.

Example:

"https://example.com/generated-video.mp4"

​
format
string

Video format.

Example:

"mp4"

​
metadata
object

Metadata about the generated video, including actual specs.

​
error
object

Error information for a failed video task.