Create a HappyHorse video

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
}

{}

{}

Use this endpoint to create a HappyHorse video task. The API returns a task ID immediately, so store the returned id and poll the task until it reaches a terminal status. POST /v1/videos uses multipart/form-data; pass scalar controls as form fields and reference images as input_reference file fields.

Choose an input mode

Goal	Model	Required fields	Optional fields
Text-to-video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`	`seconds`, `size`
Reference-to-video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, one `input_reference` file	`seconds`, `size`, more reference images

For reference-to-video, upload 1-9 reference images by repeating the input_reference multipart field. CometAPI sends each uploaded file as a HappyHorse reference image. Use JPEG, JPG, PNG, or WEBP images up to 20 MB each; for best results, use images with a shortest side of at least 400 px.

Set duration and size

Model ID	`seconds`	Default
`happyhorse-1.0`	integer `3`-`15`	`5` seconds, `1920x1080`
`happyhorse-1.1`	integer `3`-`15`	`5` seconds, `1920x1080`

Set size to an exact WxH value.

Model	Frame shape	`size` values
`happyhorse-1.0`	Landscape	`1280x720`, `1920x1080`
	Portrait	`720x1280`, `1080x1920`
	Square	`1440x1440`
`happyhorse-1.1`	Landscape	`1280x720`, `1920x1080`
	Portrait	`720x1280`, `1080x1920`
	Square	`1440x1440`
	Classic landscape	`1440x1080`
	Classic portrait	`720x960`, `1080x1440`
	Wide landscape	`2520x1080`
	Wide portrait	`1080x2520`
	Near-square landscape	`900x720`, `1350x1080`
	Near-square portrait	`720x900`, `1080x1350`

Task flow

Create the task

Send the multipart form request and store the returned id.

Poll the task

Call Retrieve a HappyHorse video until status is completed, failed, or error.

Download the result

When the task is completed, call Retrieve HappyHorse video content to download the MP4 file.

Authorizations

Authorization

string

header

required

Bearer authentication. Use your CometAPI API key.

Body

multipart/form-data

model

enum<string>

required

HappyHorse model ID for this endpoint.

Available options:

happyhorse-1.0,

happyhorse-1.1

Example:

"happyhorse-1.1"

prompt

string

required

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

Example:

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

Example:

"3"

size

string

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

Example:

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

Response

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

string

required

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

Example:

"task_example"

object

string

required

Object type. Video tasks return video.

Example:

"video"

model

string

required

Model ID used for the task.

Example:

"happyhorse-1.1"

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

Retrieve a Seedance video

Retrieve a HappyHorse video

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
}

{}

{}

Content moderation

API keys

Choose an input mode

Set duration and size

Task flow

Authorizations

Body

Response

​Choose an input mode

​Set duration and size

​Task flow

Authorizations

Body

Response

Choose an input mode

Set duration and size

Task flow