Happy Horse 1.1

Happy Horse 1.1 (alibaba/happyhorse-1.1) — видеомодель Alibaba: генерация из текста и кадра, поддержка референс-изображений. Хороша для динамичных сцен. Генерация асинхронная: POST /v1/videos возвращает задачу, дальше опрос статуса и скачивание mp4.

Параметры

Поле	Описание
model	alibaba/happyhorse-1.1 (короткое happyhorse-1.1 или псевдоним happyhorse)
prompt	Описание сцены, обязательное
seconds	Любое целое от 3 до 15; по умолчанию 3
size	Размер WxH из таблицы ниже; по умолчанию 1280x720
input_reference	Image-to-video: одна картинка как стартовый кадр, {"image_url": "data:image/...;base64,..."}
input_references	Reference-to-video: от 2 до 9 картинок в массиве, тоже только data:-URL
seed	Сид повторяемости: целое 0…2147483647. Тот же промпт с тем же сидом даёт тот же ролик; без него апстрим берёт случайный

Четырнадцать допустимых размеров — семь соотношений сторон в двух разрешениях:

Соотношение	720p	1080p
1:1	720x720	1080x1080
16:9	1280x720	1920x1080
9:16	720x1280	1080x1920
4:3	960x720	1440x1080
3:4	720x960	1080x1440
21:9	1680x720	2520x1080
9:21	720x1680	1080x2520

Значение вне списка вернёт 400 с перечнем допустимых вариантов — сверяйтесь с полем sizes в каталоге, если сомневаетесь.

Примеры

Генерация по тексту

Python

import requests

job = requests.post(
    "https://api.mixen.ai/v1/videos",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "alibaba/happyhorse-1.1",
        "prompt": "Боксёр отрабатывает серию ударов на груше, пот брызгами, быстрая смена ракурсов",
        "seconds": "6",
        "size": "1280x720",
    },
).json()
print(job["id"], job["status"])

cURL

curl https://api.mixen.ai/v1/videos \
  -H "Authorization: Bearer $MIXEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/happyhorse-1.1",
    "prompt": "Боксёр отрабатывает серию ударов на груше, пот брызгами, быстрая смена ракурсов",
    "seconds": "6",
    "size": "1280x720"
  }'

Image-to-video по стартовому кадру

Картинка передаётся одной строкой data:-URL — внешние ссылки не принимаются:

import base64
import requests

with open("hero.jpg", "rb") as f:
    img = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()

job = requests.post(
    "https://api.mixen.ai/v1/videos",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "alibaba/happyhorse-1.1",
        "prompt": "Герой срывается с места и перебирается через препятствие, резкое динамичное движение",
        "seconds": "8",
        "size": "1280x720",
        "input_reference": {"image_url": img},
    },
).json()
print(job["id"], job["status"])

В режимах с картинкой Happy Horse наследует формат кадра входного изображения — подробности в ограничениях ниже.

Reference-to-video по нескольким картинкам

От двух до девяти образцов:

{
  "model": "alibaba/happyhorse-1.1",
  "prompt": "Персонаж из первого кадра пробегает через локацию из второго, камера вдогонку",
  "seconds": "6",
  "size": "1280x720",
  "input_references": [
    "data:image/png;base64,iVBORw0...",
    "data:image/png;base64,iVBORw0..."
  ]
}

Дальше как обычно: GET /v1/videos/{id} раз в 5–10 секунд до completed, затем GET /v1/videos/{id}/content за mp4. Полный цикл — гайд по видео.

Цена

Тарификация посекундная и зависит от разрешения: 720p — 13.2089 ₽ ($0.1482) за секунду, 1080p — 17.086 ₽ ($0.1917). Списывается фактическая длительность × ставка размера. Актуальные цены — каталог.

Сильные стороны и ограничения

• Динамичные сцены — профильное применение модели: движение, экшен, смена ракурсов.
• Длительности от 3 до 15 секунд — непрерывный ряд, а не фиксированные кнопки.
• Семь форматов кадра, включая киношные 21:9 и 9:21.
• Image-to-video по стартовому кадру и reference-to-video по 2–9 образцам.
• В режимах с картинкой (стартовый кадр или референсы) модель наследует соотношение сторон входного изображения и игнорирует формат из size — поэтому в веб-форме для Happy Horse селектор формата в этих режимах скрыт. Выбранное разрешение задаёт ставку, а не геометрию результата; точный размер модель соблюдает только в text-to-video.
• Переход «первый → последний кадр» не поддерживается — передаётся только стартовый кадр.

Все модели — в каталоге. Общий порядок работы с видео — гайд по видео.