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": "happyhorse-1.0",
  "object": "video",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}
Use this endpoint after you create a HappyHorse video task. It returns the task state and includes video_url after the task is completed.

​
Check these fields

  • status tells you whether the task is queued, in_progress, completed, failed, or error.
  • 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 a HappyHorse video and store the returned id.
2

Poll by task ID

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

Download the MP4 file

When status is completed, call Retrieve HappyHorse 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

Current HappyHorse video task state.

​
id
string
required

Task ID. Use this value as task_id in retrieve and content requests.

Example:

"task_example"

​
object
string
required

Object type. HappyHorse video tasks return video.

Example:

"video"

​
model
string
required

Model ID used for the task.

Example:

"happyhorse-1.0"

​
status
enum<string>
required

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

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

"queued"

​
progress
integer
required

Task progress as a coarse percentage.

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

0

​
created_at
integer
required

Task creation time as a Unix timestamp in seconds.

Example:

1779938152

​
task_id
string

Compatibility alias for id. The value matches id when present.

Example:

"task_example"

​
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.