Alibaba
HappyHorse 1.1
happyhorse-1.1/reference-to-video
Видеомодель Alibaba: одна модель охватывает генерацию видео из текста, из изображения и из референсного изображения, поддерживает 1080p и ролики длительностью 3–15 секунд, а объединение нескольких референсных изображений усиливает согласованность персонажей — подходит для многокадрового повествования и рекламных материалов для электронной коммерции
Попробовать happyhorse-1.1/reference-to-video
Ввод
Работы
Все работыВывод
videoЦены
happyhorse-1.1/reference-to-video per second
| Характеристики | Цена за единицу |
|---|---|
| 720P | $0.160 |
| 1080P | $0.210 |
Краткое описание
happyhorse-1.1/reference-to-video — это модель линейки Alibaba happyhorse-1.1, ориентированная на генерацию видео по референсным изображениям (R2V) и доступная через единый интерфейс HiAPI.ai. Она принимает от 1 до 9 референсных изображений и текстовый промпт, объединяет признаки субъектов с нескольких изображений и создаёт короткое видео длительностью от 3 до 15 секунд в разрешении 720p или 1080p с поддержкой различных соотношений сторон, включая 16:9, 9:16 и 1:1. Эта модель делает акцент на согласованности внешнего вида субъектов и персонажей между разными кадрами, что делает её подходящей для производственных задач, требующих стабильного отображения персонажей: коротких сериалов, рекламы для электронной коммерции, брендового маркетинга и CG-превизуализации.
Ключевые особенности
- Объединение до 9 референсных изображений, стабильные признаки субъектов — за один раз можно передать от 1 до 9 референсных изображений; в промпте они упоминаются по порядку как [Image 1], [Image 2], что упрощает сохранение единообразного внешнего вида персонажей и товаров в проектах с несколькими кадрами.
- Длительность одного сегмента от 3 до 15 секунд, стоимость зависит от длительности — длительность можно задать от 3 до 15 секунд по необходимости; оплата взимается за секунды выходного видео, поэтому и пробные короткие фрагменты, и полные сцены создаются в рамках одной модели.
- Два разрешения — 720p и 1080p, девять вариантов соотношения сторон — поддерживаются разрешения 720p и 1080p, а соотношения сторон охватывают 16:9, 9:16, 1:1, 4:5, 21:9 и другие, что позволяет сразу готовить видео под конкретную платформу публикации.
Описание возможностей
Генерация по нескольким референсным изображениям: при передаче от 1 до 9 референсных изображений вместе с текстовым промптом модель объединяет признаки субъектов с референсов и генерирует видео, что подходит для последовательного создания контента с фиксированным внешним видом персонажа или товара.
Управляемая длительность и разрешение: длительность одного видео задаётся от 3 до 15 секунд, выходное разрешение выбирается из 720p или 1080p; разработчики могут гибко управлять масштабом генерации и условиями тарификации в зависимости от этапа производства.
Адаптация под различные соотношения сторон: поддерживается девять форматов вывода — 16:9, 9:16, 3:4, 4:3, 4:5, 5:4, 1:1, 9:21 и 21:9; одни и те же референсные материалы можно повторно использовать для горизонтальных, вертикальных и квадратных размещений.
Совместная генерация изображения и звука: в этой версии улучшена совместная генерация видео и аудио — синхронизация звука и изображения в выходном видео стала точнее, что снижает объём работы по выравниванию на постпродакшене.
Сценарии применения
- Команды коротких сериалов: референсы персонажей + промпты для раскадровки — использование нескольких референсных изображений персонажа для сохранения единообразного внешнего вида и пакетная генерация фрагментов для каждого кадра с последующим монтажом в готовый короткий сериал.
- Электронная коммерция: многракурсные фото товара + текст с преимуществами — генерация динамичных демонстрационных роликов на основе реальных фотографий товара для прямого использования на страницах товара и в рекламных материалах для ленты.
- Брендовый маркетинг: изображения виртуального персонажа + сценарий кампании — фиксация внешнего вида виртуального персонажа и генерация маркетинговых роликов в разных форматах по сценарию для распространения на горизонтальных и вертикальных каналах.
- CG-превизуализация: концепт-арт + описание кадра — быстрый перевод концепт-изображений в динамичные превизуализационные фрагменты для проверки ритма кадров и композиции на раннем этапе, что снижает затраты на пробы и ошибки при основном производстве.
Ограничения и рекомендации по выбору
Максимальная длительность одного сегмента — 15 секунд; для более длинного повествования требуется генерировать фрагменты по отдельности и затем склеивать их. Максимальное выходное разрешение — 1080p, поэтому модель не подходит для кинопроизводственной сдачи в высоком разрешении. Принимаются только текстовые и графические входные данные; ввод в стиле видеомонтажа или продолжение видео не поддерживаются. Улучшения этой версии по сравнению с 1.0 в основном описаны поставщиком и не имеют публичных количественных критериев, поэтому при выборе рекомендуется протестировать модель на собственных материалах. Оплата поминутная (по секундам), длительная генерация или генерация нескольких вариантов накапливает затраты, поэтому сначала рекомендуется проверить результат на коротких фрагментах длительностью 3–5 секунд. Если требуется кинематографическое движение, управляемое исключительно текстом, стоит рассмотреть модели линейки text-to-video или другие модели.
Частые вопросы
Все частые вопросы →-
Требуется ли загружать изображение для HappyHorse 1.1 Reference to Video?
Да. Текущий маршрут happyhorse-1.1/reference-to-video — это генерация видео по референсу: можно использовать референсное изображение для задания субъекта, стиля и сцены, а Prompt отвечает за движение, ракурс и изменения окружения.
-
Какие длительности и разрешения поддерживает HappyHorse 1.1 Reference to Video?
Текущий контракт запросов HiAPI поддерживает 3–15 с, выходное разрешение — 720p, 1080p. Допустимые значения см. в панели параметров страницы и документации API.
-
Как рассчитывается стоимость HappyHorse 1.1 Reference to Video?
Стоимость задачи рассчитывается по длительности выходного видео и выбранному тарифу. На странице отображается актуальная цена в глобальных единицах суммы; окончательное списание определяется записью успешной задачи.
-
Как повысить стабильность субъекта при генерации видео из изображения?
Используйте входное изображение с чётким субъектом, небольшим количеством перекрытий и полной композицией; в Prompt сначала опишите основное действие и движение камеры, затем перечислите внешний вид, материалы и взаимосвязь с фоном, которые необходимо сохранить. Для первого теста рекомендуется использовать более короткую длительность.
Создать задачу генерации
https://api.hiapi.ai/v1/tasks Заголовки
AuthorizationstringОбязательноAPI-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ
Content-TypestringНеобязательноТело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.
Idempotency-KeystringНеобязательноКлюч идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.
При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.
Тело запроса
modelstringОбязательноТекущее фиксированное значение: happyhorse-1.1/reference-to-video
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для happyhorse-1.1/reference-to-video и маршрута default — см. таблицу параметров ниже.
promptstringОбязательноmaxLength 5000Текстовый промпт, описывающий желаемое содержимое генерируемого видео; в промпте ссылайтесь на референсные изображения в виде [Image 1], [Image 2]…, порядок нумерации должен совпадать с порядком в массиве reference_image.
durationintegerНеобязательноПо умолчанию: 5min 3max 15Длительность выходного видео в секундах, принимает значения 3-15; по умолчанию 5 секунд, стоимость растёт с увеличением длительности.
resolutionstringНеобязательноПо умолчанию: "1080p"Разрешение выходного видео, по умолчанию 1080p; чем выше разрешение, тем выше стоимость.
720p1080paspect_ratiostringНеобязательноПо умолчанию: "16:9"Соотношение сторон кадра выходного видео, по умолчанию 16:9.
16:99:163:44:34:55:41:19:21Показать все (1)
21:9reference_imagearrayОбязательноminItems 1maxItems 9Массив URL референсных изображений, используемых для ограничения генерируемого содержимого; можно передать от 1 до 9 изображений; поддерживаются форматы JPEG/PNG/WEBP, минимальная сторона каждого изображения не менее 400px, размер не более 20MB.
Array [ string ]
callbackobjectНеобязательно
Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.
Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.
urlstringОбязательноОбязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.
whenstringНеобязательноПо умолчанию: "final"Сейчас поддерживается только final — уведомление и при success, и при fail.
finalstoragestringНеобязательноПо умолчанию: "temp"Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.
temppersistentПримеры запроса
# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-1.1/reference-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "1080p",
"aspect_ratio": "16:9",
"reference_image": "…"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "happyhorse-1.1/reference-to-video",
input: {
"prompt": "…",
"duration": 5,
"resolution": "1080p",
"aspect_ratio": "16:9",
"reference_image": "…"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "happyhorse-1.1/reference-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "1080p",
"aspect_ratio": "16:9",
"reference_image": "…"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Получить детали задачи
https://api.hiapi.ai/v1/tasks/:id Поля ответа
taskIdstringОбязательноИдентификатор задачи, всегда с префиксом tk-hiapi-.
modelstringОбязательноПолное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.
routestringНеобязательноПрисутствует только при явном параметре route; повторяет переданное значение.
statusstringОбязательноСтатус задачи.
queued В очереди, ещё не начата.
handling Обрабатывается.
archiving Обработка завершена, готовятся артефакты.
success Терминальное: завершено, артефакты доступны (возвращается output).
fail Терминальное: ошибка (возвращается error).
После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.
creatednumberОбязательноВремя создания задачи (Unix-секунды).
completednumberОбязательноUnix-секунды терминального состояния; до этого — 0.
outputarrayНеобязательно
Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).
Array [ object ]
Элементы массива
urlstringОбязательноURL артефакта, доступен для скачивания напрямую.
typestringОбязательноТекущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.
expireAtnumberОбязательноUnix-секунды доступности артефакта; скачайте или перенесите до истечения.
errorobjectНеобязательно
Только при status == fail.
codestringОбязательноБизнес-код ошибки.
messagestringОбязательноОписание ошибки.
Примеры ответа
Успех
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} Обработка (не финальное)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Ошибка
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Статьи
Все статьи →-
Руководство
Как вызвать hailuo-2.3-fast/image-to-video через HiAPI API: практика с curl и Python
Первый рабочий запрос к быстрому и недорогому уровню генерации видео по изображению — от ID модели до загрузки MP4
-
Руководство
Как использовать kling-4.0/text-to-video через HiAPI API: curl, Python и рабочий пример запроса
Практическое руководство для разработчиков: кинематографичные промпты, синхронный звук, асинхронный опрос и скачивание результатов
-
Руководство
kandinsky-6.0-pro/image-to-video в HiAPI: руководство по curl + Python
Как выполнить рабочий запрос генерации видео из изображения в HiAPI: от загрузки первого кадра до асинхронного опроса и финальной загрузки
-
Руководство
Как вызывать kling-4.0/image-to-video на HiAPI: curl, Python и опрос
-
Руководство
Использование Kandinsky 6.0 Pro для преобразования текста в видео на HiAPI: руководство по curl и Python
Практическая демонстрация с упором на запросы: построение вызова от промпта до видеоклипа, отправка запроса, опрос статуса завершения и скачивание результата
-
Руководство
Как вызывать hailuo-2.3/text-to-video через API HiAPI: curl, Python и рабочие примеры запросов
Похожие модели
Все модели →Тот же тип
-
Grok Imagine 1.5 Lite xAI $0.029 /секунду -
Wan 2.7 Video Alibaba $0.100 /секунду -
Veo 3.1 Fast Google $0.170 /секунду -
FLUX 3 Max Black Forest Labs $0.061 /секунду -
PixVerse V6 PixVerse $0.036 /секунду -
Gemini Omni Google -- -
Seedance 2.5 ByteDance $0.121 /секунду -
Kandinsky 6.0 Pro $1.93 /видео -
HeyGen Avatar IV HeyGen $0.150 /секунду -
Wan 3.0 Video Alibaba $0.040 /секунду -
Wan 2.6 Flash Alibaba $0.043 /секунду -
Kling 3.0 Turbo Kuaishou $0.130 /секунду
Тот же вендор
-
HappyHorse 1.1 Alibaba $0.160 /секунду -
Qwen Audio 3.0 TTS Alibaba $0.030 /1 000 символов -
HappyHorse 1.0 Alibaba $0.168 /секунду -
Qwen Image 2.1 Alibaba $0.020 /изображение -
Z-Image Alibaba $0.008 /изображение -
Wan 2.7 Image Alibaba $0.035 /изображение -
Qwen Image 2.0 Alibaba $0.042 /изображение -
Qwen Image 3.0 Alibaba $0.036 /изображение -
Wan 2.7 Video Alibaba $0.100 /секунду -
Wan 2.6 Flash Alibaba $0.043 /секунду -
Wan 3.0 Video Alibaba $0.040 /секунду



