Створити відео 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`
Reference-to-video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, один файл `input_reference`	`seconds`, `size`, більше референсних зображень

Для reference-to-video завантажте 1–9 референсних зображень, повторюючи multipart-поле input_reference. CometAPI надсилає кожен завантажений файл як референсне зображення HappyHorse. Використовуйте зображення JPEG, JPG, PNG або WEBP розміром до 20 МБ кожне; для найкращих результатів використовуйте зображення, у яких коротша сторона становить щонайменше 400 px.

Налаштуйте тривалість і розмір

Model ID	`seconds`	За замовчуванням
`happyhorse-1.0`	integer `3`-`15`	`5` секунд, `1920x1080`
`happyhorse-1.1`	integer `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.

Опитуйте завдання

Викликайте Отримати відео 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-ключі

Створити відео HappyHorse

Виберіть режим введення

Налаштуйте тривалість і розмір

Потік завдання

Авторизації

Тіло

Відповідь

​Виберіть режим введення

​Налаштуйте тривалість і розмір

​Потік завдання

Авторизації

Тіло

Відповідь

Виберіть режим введення

Налаштуйте тривалість і розмір

Потік завдання