Skip to main content
GET
cURL
Gebruik dit endpoint nadat je een HappyHorse-videotaak hebt aangemaakt. Het retourneert de taakstatus en bevat video_url nadat de taak is voltooid.

Controleer deze velden

  • status vertelt je of de taak queued, in_progress, completed, failed of error is.
  • progress is een globale voltooiingspercentage.
  • video_url verschijnt in voltooide responses.
  • error verschijnt wanneer een taak mislukt.

Polling-verloop

1

Maak eerst de taak aan

Begin met Een HappyHorse-video maken en sla de geretourneerde id op.
2

Poll op task ID

Stuur de task ID naar dit endpoint totdat status completed, failed of error bereikt.
3

Download het MP4-bestand

Wanneer status completed is, roep je HappyHorse-video-inhoud ophalen aan.

Autorisaties

Authorization
string
header
vereist

Bearer authentication. Use your CometAPI API key.

Padparameters

task_id
string
vereist

Task ID returned by POST /v1/videos.

Respons

Current HappyHorse video task state.

id
string
vereist

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

Voorbeeld:

"task_example"

object
string
vereist

Object type. HappyHorse video tasks return video.

Voorbeeld:

"video"

model
string
vereist

Model ID used for the task.

Voorbeeld:

"happyhorse-1.0"

status
enum<string>
vereist

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

Beschikbare opties:
queued,
in_progress,
completed,
failed,
error
Voorbeeld:

"queued"

progress
integer
vereist

Task progress as a coarse percentage.

Vereist bereik: 0 <= x <= 100
Voorbeeld:

0

created_at
integer
vereist

Task creation time as a Unix timestamp in seconds.

Voorbeeld:

1779938152

task_id
string

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

Voorbeeld:

"task_example"

completed_at
integer

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

Voorbeeld:

1779938219

video_url
string

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

Voorbeeld:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.