Skip to main content
GET
cURL
Verwenden Sie diesen Endpoint, nachdem Sie eine HappyHorse-Video-Task erstellt haben. Er gibt den Task-Status zurück und enthält video_url, nachdem der Task abgeschlossen ist.

Prüfen Sie diese Felder

  • status sagt Ihnen, ob der Task queued, in_progress, completed, failed oder error ist.
  • progress ist ein grober Abschlussprozentsatz.
  • video_url erscheint in abgeschlossenen Antworten.
  • error erscheint, wenn ein Task fehlschlägt.

Polling-Ablauf

1

Erstellen Sie zuerst die Task

Beginnen Sie mit Ein HappyHorse-Video erstellen und speichern Sie die zurückgegebene id.
2

Nach Task-ID pollen

Senden Sie die Task-ID an diesen Endpoint, bis status completed, failed oder error erreicht.
3

Die MP4-Datei herunterladen

Wenn status completed ist, rufen Sie HappyHorse-Videoinhalt abrufen auf.

Autorisierungen

Authorization
string
header
erforderlich

Bearer authentication. Use your CometAPI API key.

Pfadparameter

task_id
string
erforderlich

Task ID returned by POST /v1/videos.

Antwort

Current HappyHorse video task state.

id
string
erforderlich

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

Beispiel:

"task_example"

object
string
erforderlich

Object type. HappyHorse video tasks return video.

Beispiel:

"video"

model
string
erforderlich

Model ID used for the task.

Beispiel:

"happyhorse-1.0"

status
enum<string>
erforderlich

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

Verfügbare Optionen:
queued,
in_progress,
completed,
failed,
error
Beispiel:

"queued"

progress
integer
erforderlich

Task progress as a coarse percentage.

Erforderlicher Bereich: 0 <= x <= 100
Beispiel:

0

created_at
integer
erforderlich

Task creation time as a Unix timestamp in seconds.

Beispiel:

1779938152

task_id
string

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

Beispiel:

"task_example"

completed_at
integer

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

Beispiel:

1779938219

video_url
string

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

Beispiel:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.