创建 HappyHorse 视频

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=happyhorse-1.1 \
  -F 'prompt=A close-up cinematic shot of a ceramic coffee cup on a wooden table. Steam rises slowly while morning light moves across the background.' \
  -F seconds=3 \
  -F size=1920x1080

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "happyhorse-1.1",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

{}

{}

使用此端点创建 HappyHorse 视频任务。API 会立即返回任务 ID，因此请保存返回的 id，并轮询任务直到其达到终态状态。 POST /v1/videos 使用 multipart/form-data；将标量控制项作为表单字段传递，将参考图像作为 input_reference 文件字段传递。

选择输入模式

目标	Model	必填字段	可选字段
文本生成视频	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`	`seconds`, `size`
参考图生成视频	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, 一个 `input_reference` 文件	`seconds`, `size`, 更多参考图像

对于参考图生成视频，可通过重复 input_reference multipart 字段上传 1-9 张参考图像。CometAPI 会将每个上传的文件作为一张 HappyHorse 参考图像发送。请使用 JPEG、JPG、PNG 或 WEBP 格式的图像，每张最大 20 MB；为获得最佳效果，建议使用最短边至少为 400 px 的图像。

设置时长和尺寸

Model ID	`seconds`	默认值
`happyhorse-1.0`	整数 `3`-`15`	`5` 秒，`1920x1080`
`happyhorse-1.1`	整数 `3`-`15`	`5` 秒，`1920x1080`

将 size 设置为精确的 WxH 值。

Model	画幅	`size` 值
`happyhorse-1.0`	横向	`1280x720`, `1920x1080`
	纵向	`720x1280`, `1080x1920`
	方形	`1440x1440`
`happyhorse-1.1`	横向	`1280x720`, `1920x1080`
	纵向	`720x1280`, `1080x1920`
	方形	`1440x1440`
	经典横向	`1440x1080`
	经典纵向	`720x960`, `1080x1440`
	宽幅横向	`2520x1080`
	宽幅纵向	`1080x2520`
	近方形横向	`900x720`, `1350x1080`
	近方形纵向	`720x900`, `1080x1350`

任务流程

创建任务

发送 multipart 表单请求，并保存返回的 id。

轮询任务

调用获取 HappyHorse 视频，直到 status 为 completed、failed 或 error。

下载结果

当任务为 completed 时，调用获取 HappyHorse 视频内容下载 MP4 文件。

授权

Authorization

string

header

必填

Bearer authentication. Use your CometAPI API key.

请求体

multipart/form-data

model

enum<string>

必填

HappyHorse model ID for this endpoint.

可用选项:

happyhorse-1.0,

happyhorse-1.1

示例:

"happyhorse-1.1"

prompt

string

必填

Text prompt that describes the video to generate. For reference-image requests, combine the prompt with the uploaded reference image.

示例:

"Use the uploaded reference image as the visual guide. Create a short cinematic shot with gentle natural motion."

seconds

string

Requested clip duration in seconds. Use an integer from 3 through 15. Default is 5.

示例:

"3"

size

string

Output size as an exact WxH value. Use one of the documented size values for the selected HappyHorse model.

示例:

"1920x1080"

input_reference

file

Reference image file for reference-to-video. Required when using reference-to-video; repeat this multipart field to send additional reference images. CometAPI preserves upload order. Use JPEG, JPG, PNG, or WEBP images up to 20 MB each.

响应

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

string

必填

Task ID. Use this value with retrieve and content endpoints.

示例:

"task_example"

object

string

必填

Object type. Video tasks return video.

示例:

"video"

model

string

必填

Model ID used for the task.

示例:

"happyhorse-1.1"

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

获取 Seedance 视频

获取 HappyHorse 视频

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=happyhorse-1.1 \
  -F 'prompt=A close-up cinematic shot of a ceramic coffee cup on a wooden table. Steam rises slowly while morning light moves across the background.' \
  -F seconds=3 \
  -F size=1920x1080

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "happyhorse-1.1",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

{}

{}

内容审核

API 密钥

选择输入模式

设置时长和尺寸

任务流程

授权

请求体

响应

​选择输入模式

​设置时长和尺寸

​任务流程

授权

请求体

响应

选择输入模式

设置时长和尺寸

任务流程