Skip to main content
GET
/
v1
/
videos
/
{task_id}
cURL
curl https://api.cometapi.com/v1/videos/<TASK_ID> \
  -H "Authorization: Bearer $COMETAPI_KEY"
{
  "id": "task_example",
  "model": "omni-fast",
  "object": "video",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}
Use this endpoint after you create a beta Omni video task. It returns the task state and includes video_url after the task is completed. Beta

​
Check these fields

  • status tells you whether the task is queued, in_progress, completed, or failed.
  • progress is a coarse completion percentage.
  • video_url appears on completed responses.
  • error appears when a task fails.

​
Polling flow

1

Create the task first

Start with Create an Omni video and store the returned id.
2

Poll by task ID

Send the task ID to this endpoint until status reaches completed or failed.
3

Download the MP4 file

When status is completed, call Retrieve Omni video content.

Authorizations

​
Authorization
string
header
required

Bearer authentication. Use your CometAPI API key.

Path Parameters

​
task_id
string
required

Task ID returned by POST /v1/videos.

Response

Omni video task state.

​
id
string
required

Task ID returned by POST /v1/videos.

Example:

"task_example"

​
object
string
required

Object type. Omni video tasks return video.

Example:

"video"

​
model
string
required

Model ID used for the task.

Example:

"omni-fast"

​
status
enum<string>
required

Task lifecycle status. Poll until the value is completed or failed.

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

"completed"

​
progress
integer
required

Task progress as a coarse percentage.

Required range: 0 <= x <= 100
Example:

100

​
created_at
integer
required

Task creation time as a Unix timestamp in seconds.

Example:

1779938152

​
completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Example:

1779938219

​
video_url
string

Temporary video delivery URL. This field appears on completed tasks.

Example:

"<temporary-video-url>"

​
error
object

Failure details. This field appears when the task fails.