HappyHorse 1.0 API

Alibaba HappyHorse 1.0 для генерации видео по тексту, первому кадру или референсным изображениям в разрешении 720p или 1080p.

Прогрет Official Live Тарификация по маршруту Конфиденциальность данных Без обучения моделей Документация API

Входные данные

prompt*string

Опишите объект, движение, камеру, освещение и тайминг

route_modestring

Выберите маршрут провайдера для этого запроса.

Более экономичный официальный маршрут по умолчанию для новых запросов и API-ключей.

generation_typestring

Выберите рабочий процесс генерации. Режим API обновится в соответствии с выбором.

aspect_ratiostring

Соотношение сторон сгенерированного результата

По умолчанию: «16:9»

resolutionstring

Генерация в более высоком разрешении может занять больше времени.

По умолчанию: «720p»

durationnumber

Длительность создаваемого видео в секундах

Результат

Готово к запускуНастройте входные параметры и запустите модель.

Быстрый старт

Справочник Video API

Создайте API-ключ
Создайте ключ в консоли и сохраните его в переменной окружения MLMUX_API_KEY.
Создать API-ключ
Отправьте запрос
Отправьте запрос на https://api.mlmux.com/v1/videos/generations с идентификатором модели alibaba/happyhorse-1.0. В примере используются настройки по умолчанию с этой страницы; измените промпт и параметры при необходимости.
Получите результат
Ответ представляет собой задачу. Опрашивайте poll_url каждые несколько секунд, пока status не станет succeeded, затем скачайте видео или настройте webhook для получения уведомлений.

curl https://api.mlmux.com/v1/videos/generations \
  -H "Authorization: Bearer $MLMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "alibaba/happyhorse-1.0",
  "route_mode": "official-cheap",
  "prompt": "A red fox walks through fresh snow at sunrise, slow tracking shot, cinematic light",
  "mode": "text_to_video",
  "ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

# The response is a task. Poll it until "status" is "succeeded", then read "video".
curl https://api.mlmux.com/v1/videos/generations/TASK_ID \
  -H "Authorization: Bearer $MLMUX_API_KEY"

Примеры

Больше примеров ↗

Тарифы

Видео тарифицируется за секунду результата в выбранном разрешении. Цена зависит от разрешения и маршрута.

Подробнее о тарифах ↗

Все тарифы на видео

За секунду готового видео, в зависимости от разрешения. Расчет основывается на количестве секунд, возвращенном провайдером.

Разрешение	official	official-cheap
720p	$0.138 / с	$0.125 / с
1080p	$0.246 / с	$0.222 / с

Readme

HappyHorse 1.0 доступна через MLMux с единым форматом запроса и двумя уровнями маршрутизации.

Три способа генерации

Задайте промпт, анимируйте исходное изображение или направьте генерацию с помощью референсных изображений.

720p или 1080p

Ролики длительностью от 3 до 15 секунд в разрешении 720p или 1080p.

Выбор модели HappyHorse

HappyHorse 1.1 поддерживает 480p и выгоднее по цене в 1080p; HappyHorse 1.0 Video Edit позволяет изменять существующие видео.

Частые вопросы

Что такое HappyHorse 1.0?

HappyHorse 1.0 — модель генерации видео от Alibaba. В MLMux её можно запустить в браузере или вызвать через один API. Alibaba HappyHorse 1.0 для генерации видео по тексту, первому кадру или референсным изображениям в разрешении 720p или 1080p.

Как использовать API HappyHorse 1.0?

Создайте API-ключ в MLMux Console, затем отправьте POST-запрос на https://api.mlmux.com/v1/videos/generations с ключом в заголовке Authorization и параметром model, равным alibaba/happyhorse-1.0. Запрос возвращает задачу: опрашивайте её или получите вебхук, когда видео будет готово.

Что умеет HappyHorse 1.0?

Режимы генерации: Текст в видео, Изображение в видео и Мультимодальный референс. Длительность клипов — от 3 до 15 секунд в 720p или 1080p, соотношение сторон, например 16:9, 9:16, 1:1, 4:3 и 3:4, до 9 референсных изображений.

Сколько стоит HappyHorse 1.0?

В MLMux действует оплата по факту использования (pay-as-you-go) без подписок и ежемесячных платежей, где 1 кредит равен 1 доллару США. Одна секунда видео 720p в HappyHorse 1.0 стоит $0.125 на маршруте по умолчанию official-cheap и $0.138 на маршруте official. Тарифы для каждого разрешения приведены в разделе цен на этой странице.

Можно ли попробовать HappyHorse 1.0 без кода?

Да. Войдите в аккаунт и используйте плейграунд в верхней части этой страницы, чтобы запустить HappyHorse 1.0 с теми же настройками, что и в API. В окне просмотра кода плейграунда отображается соответствующий вашим настройкам запрос, а в разделе быстрого старта ниже приведены готовые примеры для cURL, Python и JavaScript.