Обзор
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 референсных изображений.Позвольте ИИ-агенту выполнить интеграцию
.md к любому docs URL), а затем пишет код в стеке вашего проекта — асинхронный опрос, почему нельзя использовать /v1/videos, ошибка отсутствующего X-DashScope-Async и правило целого duration уже заложены в требования.Пусть кодирующий агент выполнит интеграцию или диагностику HappyHorse text-to-video, image-to-video, reference-to-video и редактирования видео. Скопируйте и вставьте это в Codex, Claude Code, Cursor и аналогичные инструменты.
От чего этот prompt вас избавляет
От чего этот prompt вас избавляет
Почему стоит выбрать 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 замена одежды / замена фона