ToAPIsToAPIs
HappyHorse

HappyHorse 1.1 Генерация видео

Генерация, reference-to-video и редактирование видео с HappyHorse 1.1

POST
/v1/videos/generations

Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.

  • Публичное имя модели: happyhorse-1.1
  • Используйте action для выбора text-to-video, image-to-video, reference-to-video или video editing
  • Если action не указан, запрос с first-frame изображением считается image-to-video, иначе text-to-video
  • Асинхронное управление задачами через стандартный эндпоинт статуса video task

Авторизация

Authorizationstringзаголовокобязательно

Все запросы требуют Bearer Token.

Authorization: Bearer YOUR_API_KEY

Тело запроса

modelstringтелообязательнопо умолчанию: happyhorse-1.1

Название модели генерации видео. Фиксированное значение: happyhorse-1.1.

actionstringтелопо умолчанию: text-to-video

Режим генерации.

Варианты:

  • text-to-video
  • image-to-video
  • reference-to-video
  • video-edit
promptstringтело

Текстовое описание видео. Обязательно для text-to-video, reference-to-video и video-edit.

image_urlsstring[]тело

URL first-frame изображения для image-to-video. Используется только первое изображение.

Также принимаются совместимые поля: input_reference, images, image или image_with_roles[{ role: "first_frame" }].

reference_imagesstring[]тело

URL reference изображений. Для reference-to-video требуется от 1 до 9 изображений; для video-edit можно передать до 5.

urlstringтело

URL входного видео для редактирования. Обязательно при action=video-edit.

audio_settingstringтелопо умолчанию: auto

Управление аудио для video-edit: auto или origin.

durationintegerтелопо умолчанию: 5

Длительность видео в секундах. Диапазон: 3–15.

resolutionstringтелопо умолчанию: 1080P

Разрешение видео: 720P или 1080P.

aspect_ratiostringтелопо умолчанию: 16:9

Соотношение сторон для text-to-video: 16:9, 9:16, 1:1, 4:3, 3:4.

seedintegerтело

Random seed для воспроизводимой генерации.

watermarkbooleanтелопо умолчанию: true

Добавлять ли watermark.

Пример запроса

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "happyhorse-1.1",
    "action": "text-to-video",
    "prompt": "A cinematic city scene at night",
    "duration": 10,
    "resolution": "1080P",
    "aspect_ratio": "16:9"
  }'

Проверка задачи

Эндпоинт создания возвращает task ID. Используйте стандартный video task status endpoint для получения результата:

curl --request GET \
  --url https://toapis.com/v1/videos/generations/{task_id} \
  --header "Authorization: Bearer YOUR_API_KEY"