HappyHorse 1.1 Генерация видео
Генерация, reference-to-video и редактирование видео с HappyHorse 1.1
Для пользователей из материкового Китая: используйте 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-videoimage-to-videoreference-to-videovideo-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"