Skip to main content

Обзор

HappyHorse (快马) — это серия моделей генерации видео Alibaba, ориентированная на высокоточное динамическое создание видео — она точно понимает семантику текста и выдает плавные, естественные, детализированные, высококачественные видео, в которых объекты остаются стабильными. APIYI подключается напрямую через канал passthrough DashScope, поэтому один APIYI Key позволяет вызывать все возможности HappyHorse. Текущая флагманская версия, HappyHorse-1.1 (Video Edit по-прежнему 1.0), охватывает четыре основных сценария использования:
🐎 Ключевая особенность: Все четыре возможности используют один и тот же асинхронный эндпоинт и одну и ту же структуру запроса — при смене сценария использования изменяется только поле model. HappyHorse ориентирован на «высокоточное динамическое видео»; Референс в видео поддерживает до 9 референсных изображений, а Редактирование видео поддерживает до 5 референсных изображений, обеспечивая высокую согласованность объекта. Он использует тот же эндпоинт, что и серия Wan, и является полностью взаимозаменяемым.

API Text-to-Video

happyhorse-1.1-t2v, генерирует видео из чистого text prompt.

API Image-to-Video

happyhorse-1.1-i2v, генерирует видео из изображения первого кадра (без поддержки на основе аудио).

API Reference-to-Video

happyhorse-1.1-r2v, до 9 референсных изображений для сохранения объекта.

API Video Edit

happyhorse-1.0-video-edit, редактирует видео с помощью до 5 референсных изображений.

Почему стоит выбрать APIYI для HappyHorse

Один ключ для всех возможностей

Не нужна регистрация в Alibaba Cloud и настройка региона. Один ключ APIYI вызывает все четыре возможности HappyHorse, а также серия Wan.

Прямой доступ, VPN не нужен

Подключайтесь напрямую к api.apiyi.com, доступно из отечественных дата-центров и домашнего широкополосного интернета.

Без тарификации при сбое

Задачи, которые переходят в состояние failed (недоступный media URL, sensitive prompt и т. д.), не тарифицируются, поэтому вы можете спокойно повторить попытку.

Проксирование протокола DashScope

Использует тот же endpoint и схему, что и серия Wan; существующий код Wan может вызывать HappyHorse, просто изменив имя model.

Основные возможности

Асинхронный эндпоинт 4-в-1

t2v / i2v / r2v / video-edit используют POST /wan/api/v1/...video-synthesis; после отправки он возвращает task_id, затем вы выполняете опрос и скачиваете.

Высокоточное сохранение субъекта

Модель тяготеет к стилю «high-fidelity dynamic video», сохраняя людей/объекты более стабильными на протяжении движения.

До 9 референсных изображений

happyhorse-1.1-r2v официально поддерживает до 9 reference_image записей, обеспечивая более высокую согласованность субъекта в сценариях с несколькими референсами.

Несколько разрешений и длительностей

Разрешения 720P / 1080P, целочисленные длительности от 2 до 15 секунд и prompt_extend интеллектуальное переписывание для улучшения качества коротких prompt.

Поддерживаемые модели

⚠️ Выбор эндпоинта (Самое важное)

APIYI одновременно монтирует два пути, и только эндпоинт DashScope passthrough полностью пригоден для всех возможностей HappyHorse:
HappyHorse и Wan используют один и тот же endpoint passthrough. Если вы видите в какой-либо документации/примере отправку задачи на видео через /v1/videos, игнорируйте это. Все запросы на создание проходят через /wan/api/v1/...video-synthesis, а все запросы на получение статуса — через /v1/tasks/{task_id}.

Асинхронный поток вызовов

Весь поток асинхронный и состоит из трех шагов: создать задачу → опросить статус → скачать видео.
1

Создать задачу

POST /wan/api/v1/services/aigc/video-generation/video-synthesis, с заголовком запроса X-DashScope-Async: enable. Он сразу возвращает task_id.
2

Опросить статус

GET /v1/tasks/{task_id}Authorization), выполняя запрос каждые 5–10 секунд (не реже чем раз в 3 секунды), пока status не станет completed.
3

Скачать видео

Выполните GET для mp4 напрямую по result_url в ответе, без заголовка Authorization (это подписанная прямая ссылка OSS; если включить Auth, будет 403).

Справка по статусам задачи

Полный Python Client

Ключевые параметры: пояснение

При отправке тело использует вложенную структуру DashScope: { model, input: { prompt, media[] }, parameters: {...} }.

Типы media[]

i2v в HappyHorse не поддерживает driving_audio (audio-driven — это возможность, доступная только в Wan2.7-i2v). Для lip-sync / rap используйте Wan2.7.

Поля parameters

duration должен быть целым числом 5, а не строкой "5"; запись resolution в верхнем регистре 720P более надежна.

Как выбрать HappyHorse или Wan

HappyHorse и Wan — это обе видеомодели Alibaba, которые используют один и тот же эндпоинт и схему (их можно взаимозаменять, просто меняя имя model), но они делают акцент на разных вещах:
Нужно несколько изображений-референсов, чтобы сохранить согласованность субъекта → выберите happyhorse-1.1-r2v (до 9). Нужны lip-sync / рэп / озвучка digital-human → выберите Wan2.7-i2v (единственный, который поддерживает управление по аудио).

Лучшие практики

1

Сначала итеративно работайте на 720P / 5 секунд

Во время разработки используйте короткие видео с низким разрешением, чтобы быстро проверять prompt и reference images, а затем повышайте разрешение и длительность после завершения настройки.
2

Всегда включайте prompt_extend

prompt_extend: true заметно повышает качество коротких prompt.
3

Проверяйте каждые 5–10 секунд

Не опускайтесь ниже 3 секунд (иначе вас ограничат по лимиту запросов). Каждая возможность HappyHorse на 720P / 5 секунд обычно занимает 105–115 секунд.
4

Установите клиентский тайм-аут 20 минут в качестве страховки

1080P или длинные видео значительно медленнее; установите запасной тайм-аут 20 минут для цикла опроса.
5

Скачивайте сразу после получения result_url

result_url истекает через 24 часа по умолчанию, и это подписанная прямая ссылка OSS — не включайте заголовок Authorization при скачивании.

Коды ошибок и повторные попытки

Рекомендуемое поведение клиента: используйте повторные попытки с экспоненциальной задержкой для HTTP 5xx / ошибок сети; сразу показывайте HTTP 4xx без повторной попытки; задачу failed с [InvalidImageUrl] можно повторить, тогда как сбои [InvalidParameter] / по чувствительным словам — нет.

Вопросы и ответы

Нет. Они используют один и тот же passthrough-эндпоинт DashScope, одну и ту же структуру запроса, один и тот же набор названий типов медиа и один и тот же query-эндпоинт. При переключении изменяется только поле model (например, wan2.7-t2vhappyhorse-1.1-t2v); остальная часть тела остается идентичной.
happyhorse-1.1-i2v не поддерживает поле driving_audio (audio-driven); i2v принимает только first_frame. Для синхронизации губ / рэпа / озвучки цифрового человека используйте Wan2.7-i2v.
Да. Официально поддерживается до 9 reference_image записей — просто поместите их в массив media. Чем больше референсных изображений, тем выше согласованность для объекта / одежды / сцены.
/v1/videos имеет неполную поддержку поля media в i2v / r2v, из-за чего upstream возвращает [InvalidParameter] Field required: input.media. Все запросы на создание проходят через /wan/api/v1/services/aigc/video-generation/video-synthesis, а запросы на получение — через /v1/tasks/{task_id}.
Уберите заголовок Authorization. result_url уже является подписанной прямой ссылкой OSS; если добавить ваш APIYI Key, OSS вместо этого отклонит ее. result_url по умолчанию истекает через 24 часа, поэтому загрузите его как можно скорее.
status=failed не тарифицируется. Но повторная отправка той же задачи тарифицируется снова, поэтому учитывайте идемпотентность.

Настройка группы

Серии HappyHorse и Wan используют одну общую Wan&HappyHorse группу — один Token может вызывать обе серии. Для видеомоделей тарификация идет за секунду, поэтому Token должен соответствовать двум условиям, чтобы маршрутизация прошла успешно:
  1. Модель тарификации: выберите Pay-as-you-go Priority или Pay-as-you-go — видео тарифицируется за секунду, поэтому Token с оплатой за запрос не может быть маршрутизирован
  2. Группа: выберите группу, которая включает Wan&HappyHorse
Диалог создания Token: модель тарификации установлена на Pay-as-you-go Priority, в выпадающем списке группы показан Wan&HappyHorse (коэффициент тарифа 0.14x), один Token можно использовать и для Wan2.7, и для HappyHorse

Create Token: set billing model to Pay-as-you-go Priority and group to Wan&HappyHorse (0.14x) to call every Wan2.7 and HappyHorse video model (the screenshot shows the group's former name Wan, since renamed to Wan&HappyHorse)

Тарифы

Базовая цена = 98% от официальной цены Alibaba (легко понять)

Цены моделей HappyHorse встроены в систему APIYI — ручная настройка не нужна; групповая скидка применяется автоматически. В консоли группа Wan&HappyHorse показывает коэффициент тарифа 0.14x, который выражается во встроенной единице тарификации RMB. Поскольку APIYI выставляет счета в USD по фиксированному курсу 1:7, фактический пересчет выглядит так:
Иными словами, базовая цена = 98% от официальной цены Alibaba — дешевле, чем покупать напрямую у Alibaba, и без необходимости самостоятельно настраивать зарубежный канал.
Пересчет: цена в USD за секунду = официальная цена в RMB × 0.14 (то есть × 0.98 ÷ 7).

Подробности цены (базовая цена, тарификация по секундам)

HappyHorse-1.1 text-to-video / image-to-video / reference-to-video стоят одинаково, с двумя уровнями — 720P / 1080P (480P не поддерживается):
  • Длительность выходного видео в happyhorse-1.0-video-edit соответствует исходному видео и тарифицируется по фактическим секундам выхода, а не по duration.
  • Указанные цены — это базовые (98% от официальной); при максимальном бонусе за пополнение эффективная цена составляет примерно значение из таблицы ÷ 1.2 (например, 1080P 5 с $1.12 → примерно $0.93).

Накопительные бонусы за пополнение для еще более низкой эффективной цены

После подключения к программе бонусов за пополнение зачисленный баланс можно увеличить примерно до 1.2x, что еще сильнее снижает эффективную цену:
Так крупные клиенты могут опустить цену примерно до ~81% от официальной цены (0.98 ÷ 1.2 ≈ 0.816).
  • Единица тарификации = уровень разрешения × длительность (секунды); неудачные задания не тарифицируются.
  • 1:7 — это фиксированный курс взаиморасчетов (не льготный курс); он одинаково применяется ко всем пополнениям в USD.
  • Сведения о самых высоких уровнях бонусов и подходящих каналах см. в бонусах за пополнение. Актуальный курс указан в консоли.

Связанная документация

Тестовая среда Text-to-Video

happyhorse-1.1-t2v онлайн-отладка

Тестовая среда Image-to-Video

happyhorse-1.1-i2v генерация первого кадра

Тестовая среда Reference-to-Video

happyhorse-1.1-r2v до 9 референсных изображений

Тестовая среда Video Edit

happyhorse-1.0-video-edit замена одежды / замена фона

Серия Wan

Также сравнение выбора модели Alibaba
Серия HappyHorse предоставляется через канал passthrough APIYI DashScope. По вопросам или предложениям, пожалуйста, создайте обращение в консоли APIYI.