Создать видео 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
}

{}

{}

Используйте этот endpoint, чтобы создать задачу видео HappyHorse. API сразу возвращает ID задачи, поэтому сохраните возвращённый id и опрашивайте задачу, пока она не достигнет финального статуса. POST /v1/videos использует multipart/form-data; передавайте скалярные параметры как поля формы, а референс-изображения — как файловые поля input_reference.

Выберите режим ввода

Цель	Model	Обязательные поля	Необязательные поля
Text-to-video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`	`seconds`, `size`
Видео по референсу	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, один файл `input_reference`	`seconds`, `size`, дополнительные референс-изображения

Для видео по референсу загрузите 1–9 референс-изображений, повторяя multipart-поле input_reference. CometAPI отправляет каждый загруженный файл как референс-изображение HappyHorse. Используйте изображения JPEG, JPG, PNG или WEBP размером до 20 МБ каждое; для наилучших результатов используйте изображения, у которых меньшая сторона составляет не менее 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 form request и сохраните возвращённый id.

Опросить задачу

Вызывайте Retrieve a HappyHorse video, пока status не станет completed, failed или error.

Скачать результат

Когда задача перейдёт в состояние completed, вызовите Retrieve HappyHorse video content, чтобы скачать 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-ключи

Выберите режим ввода

Задайте длительность и размер

Поток задачи

Авторизации

Тело

Ответ

​Выберите режим ввода

​Задайте длительность и размер

​Поток задачи

Авторизации

Тело

Ответ

Выберите режим ввода

Задайте длительность и размер

Поток задачи