Обзор
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
Один ключ для всех возможностей
Прямой доступ, VPN не нужен
api.apiyi.com, доступно из отечественных дата-центров и домашнего широкополосного интернета.Без тарификации при сбое
failed (недоступный media URL, sensitive prompt и т. д.), не тарифицируются, поэтому вы можете спокойно повторить попытку.Проксирование протокола DashScope
model.Основные возможности
Асинхронный эндпоинт 4-в-1
POST /wan/api/v1/...video-synthesis; после отправки он возвращает task_id, затем вы выполняете опрос и скачиваете.Высокоточное сохранение субъекта
До 9 референсных изображений
happyhorse-1.1-r2v официально поддерживает до 9 reference_image записей, обеспечивая более высокую согласованность субъекта в сценариях с несколькими референсами.Несколько разрешений и длительностей
prompt_extend интеллектуальное переписывание для улучшения качества коротких prompt.Поддерживаемые модели
⚠️ Выбор эндпоинта (Самое важное)
APIYI одновременно монтирует два пути, и только эндпоинт DashScope passthrough полностью пригоден для всех возможностей HappyHorse:Асинхронный поток вызовов
Весь поток асинхронный и состоит из трех шагов: создать задачу → опросить статус → скачать видео.Создать задачу
POST /wan/api/v1/services/aigc/video-generation/video-synthesis, с заголовком запроса X-DashScope-Async: enable. Он сразу возвращает task_id.Опросить статус
GET /v1/tasks/{task_id} (с Authorization), выполняя запрос каждые 5–10 секунд (не реже чем раз в 3 секунды), пока status не станет completed.Скачать видео
result_url в ответе, без заголовка Authorization (это подписанная прямая ссылка OSS; если включить Auth, будет 403).Справка по статусам задачи
Полный Python Client
Ключевые параметры: пояснение
При отправке тело использует вложенную структуру DashScope:{ model, input: { prompt, media[] }, parameters: {...} }.
Типы media[]
Поля parameters
Как выбрать HappyHorse или Wan
HappyHorse и Wan — это обе видеомодели Alibaba, которые используют один и тот же эндпоинт и схему (их можно взаимозаменять, просто меняя имяmodel), но они делают акцент на разных вещах:
Лучшие практики
Сначала итеративно работайте на 720P / 5 секунд
Всегда включайте prompt_extend
prompt_extend: true заметно повышает качество коротких prompt.Проверяйте каждые 5–10 секунд
Установите клиентский тайм-аут 20 минут в качестве страховки
Скачивайте сразу после получения result_url
result_url истекает через 24 часа по умолчанию, и это подписанная прямая ссылка OSS — не включайте заголовок Authorization при скачивании.Коды ошибок и повторные попытки
failed с [InvalidImageUrl] можно повторить, тогда как сбои [InvalidParameter] / по чувствительным словам — нет.Вопросы и ответы
Есть ли разница в том, как HappyHorse и Wan интегрированы?
Есть ли разница в том, как HappyHorse и Wan интегрированы?
model (например, wan2.7-t2v → happyhorse-1.1-t2v); остальная часть тела остается идентичной.Почему i2v у HappyHorse не поддерживает синхронизацию губ?
Почему i2v у HappyHorse не поддерживает синхронизацию губ?
happyhorse-1.1-i2v не поддерживает поле driving_audio (audio-driven); i2v принимает только first_frame. Для синхронизации губ / рэпа / озвучки цифрового человека используйте Wan2.7-i2v.Может ли happyhorse-1.1-r2v действительно принимать 9 референсных изображений?
Может ли happyhorse-1.1-r2v действительно принимать 9 референсных изображений?
reference_image записей — просто поместите их в массив media. Чем больше референсных изображений, тем выше согласованность для объекта / одежды / сцены.Почему я не могу отправить через /v1/videos?
Почему я не могу отправить через /v1/videos?
/v1/videos имеет неполную поддержку поля media в i2v / r2v, из-за чего upstream возвращает [InvalidParameter] Field required: input.media. Все запросы на создание проходят через /wan/api/v1/services/aigc/video-generation/video-synthesis, а запросы на получение — через /v1/tasks/{task_id}.Что делать, если при загрузке result_url возвращается 403?
Что делать, если при загрузке result_url возвращается 403?
Authorization. result_url уже является подписанной прямой ссылкой OSS; если добавить ваш APIYI Key, OSS вместо этого отклонит ее. result_url по умолчанию истекает через 24 часа, поэтому загрузите его как можно скорее.Тарифицируются ли неудачные задачи?
Тарифицируются ли неудачные задачи?
status=failed не тарифицируется. Но повторная отправка той же задачи тарифицируется снова, поэтому учитывайте идемпотентность.Настройка группы
Серии HappyHorse и Wan используют одну общуюWan&HappyHorse группу — один Token может вызывать обе серии. Для видеомоделей тарификация идет за секунду, поэтому Token должен соответствовать двум условиям, чтобы маршрутизация прошла успешно:
- Модель тарификации: выберите Pay-as-you-go Priority или Pay-as-you-go — видео тарифицируется за секунду, поэтому Token с оплатой за запрос не может быть маршрутизирован
- Группа: выберите группу, которая включает
Wan&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, фактический пересчет выглядит так:
Пересчет: цена в 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, что еще сильнее снижает эффективную цену:- Единица тарификации = уровень разрешения × длительность (секунды); неудачные задания не тарифицируются.
- 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 замена одежды / замена фона