Skip to main content
GET
cURL
在创建 HappyHorse 视频任务后,使用此端点。它会返回任务状态,并在任务完成后包含 video_url

检查这些字段

  • status 会告诉你任务是 queuedin_progresscompletedfailed 还是 error
  • progress 是一个粗略的完成百分比。
  • video_url 会出现在已完成的响应中。
  • 当任务失败时,会出现 error

轮询流程

1

先创建任务

先从创建 HappyHorse 视频开始,并保存返回的 id
2

按任务 ID 轮询

将任务 ID 发送到此端点,直到 status 变为 completedfailederror
3

下载 MP4 文件

statuscompleted 时,调用获取 HappyHorse 视频内容

授权

Authorization
string
header
必填

Bearer authentication. Use your CometAPI API key.

路径参数

task_id
string
必填

Task ID returned by POST /v1/videos.

响应

Current HappyHorse video task state.

id
string
必填

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

示例:

"task_example"

object
string
必填

Object type. HappyHorse video tasks return video.

示例:

"video"

model
string
必填

Model ID used for the task.

示例:

"happyhorse-1.0"

status
enum<string>
必填

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

可用选项:
queued,
in_progress,
completed,
failed,
error
示例:

"queued"

progress
integer
必填

Task progress as a coarse percentage.

必填范围: 0 <= x <= 100
示例:

0

created_at
integer
必填

Task creation time as a Unix timestamp in seconds.

示例:

1779938152

task_id
string

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

示例:

"task_example"

completed_at
integer

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

示例:

1779938219

video_url
string

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

示例:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.