Обзор
Wan (Tongyi Wanxiang) — это серия моделей генерации видео от Alibaba Cloud. APIYI напрямую подключается к Alibaba Cloud Model Studio через сквозной канал DashScope, поэтому один ключ APIYI (начинающийся сsk-) открывает доступ ко всем возможностям видео Wan без отдельного аккаунта Alibaba Cloud. Текущий флагман — Wan2.7, охватывающий четыре основных сценария использования:
model. Нативная поддержка разрешений 720P / 1080P и целочисленной длительности от 2 до 15 секунд; wan2.7-i2v также поддерживает управляющее аудио для синхронизации губ. Идеально подходит для производства коротких видео, материалов для e-commerce, озвучивания цифровых аватаров и креативного маркетинга.API текст-в-видео
wan2.7-t2v генерирует видео из чистого text prompt — самый простой способ начать.API изображения-в-видео
wan2.7-i2v использует первый кадр + необязательное управляющее аудио для синхронизации губ / рэпа.API референса-в-видео
wan2.7-r2v сохраняет характеристики объекта из reference images/videos, с голосовым референсом.API редактирования видео
wan2.7-videoedit редактирует видео с помощью референсных изображений: замена одежды, замена фона и т. д.Визуальное тестирование API
Поиск / загрузка асинхронных задач
Почему использовать Wan в APIYI
Один ключ APIYI для всех возможностей
Прямой доступ, без VPN
api.apiyi.com, доступно как из дата-центров материкового Китая, так и из домашних сетей, без необходимости настраивать региональный endpoint Alibaba Cloud.Нет списания при сбое
failed (недоступный media URL, чувствительный prompt, нехватка upstream-мощностей и т. д.), не тарифицируются, так что повторяйте попытки свободно.Сквозная передача протокола DashScope
Основные возможности
Асинхронный эндпоинт 4-в-1
POST /wan/api/v1/...video-synthesis. Отправьте задачу, получите task_id, опрашивайте и скачивайте. Простое управление пакетными задачами.Синхронизация губ по аудио
wan2.7-i2v поддерживает driving_audio, благодаря чему статичный портрет повторяет движения рта и ритм аудио. Отлично подходит для рэпа / озвучки / цифровых людей.Референс нескольких объектов
wan2.7-r2v объединяет референсные изображения + референсные видео (максимум 5 в сумме), которые указываются в prompt как «image 1 / video 1», с поддержкой голосового референса.Несколько разрешений и длительностей
prompt_extend умное переписывание дополнительно повышает качество для коротких prompt.Поддерживаемые модели
⚠️ Выбор эндпоинта (самое важное)
APIYI монтирует два пути, но только endpoint с проксированием DashScope полностью поддерживает все возможности Wan:Поток асинхронных вызовов
Весь процесс состоит из трёх асинхронных шагов: создание задачи → опрос статуса → скачивание видео.Создайте задачу
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).Справка по статусам задачи
Верхнеуровневое полеstatus ответа GET /v1/tasks/{task_id} (уже нормализовано APIYI):
Полный Python-клиент
Объяснение ключевых параметров
При отправке тело запроса использует вложенную структуру DashScope:{ model, input: { prompt, media[] }, parameters: {...} }.
Поля input
Типы media[]
type + url. url должен быть общедоступной ссылкой https, которую можно напрямую получить через GET (сначала загрузите локальные файлы в OSS / CDN).
Поля parameters
Выбор между Wan и HappyHorse
Wan и HappyHorse — это обе видеомодели Alibaba, и они используют один и тот же эндпоинт и схему (переключайтесь между ними, меняя только имяmodel), но их сильные стороны различаются:
Лучшие практики
Сначала тестируйте на 720P / 5 секунд
Всегда включайте prompt_extend
prompt_extend: true заметно улучшает качество для коротких prompt, ценой лишь нескольких дополнительных секунд генерации.Опрос каждые 5-10 секунд
Установите клиентский timeout на 20 минут как запасной предел
Скачивайте сразу после получения result_url
result_url по умолчанию истекает через 24 часа и представляет собой подписанную прямую ссылку OSS, поэтому при скачивании не отправляйте заголовок Authorization. В production всегда пересохраняйте его в своем OSS / CDN.Делайте отправки идемпотентными
Коды ошибок и повторные попытки
Ошибки возникают на двух этапах и обрабатываются по-разному:failed с [InvalidImageUrl] можно повторить (возможно, временная проблема сети), а [InvalidParameter] / чувствительные слова не следует повторять.FAQ
Почему я не могу использовать /v1/videos для отправки задач Wan?
Почему я не могу использовать /v1/videos для отправки задач Wan?
/v1/videos — это эндпоинт OpenAI плоского формата с неполной поддержкой i2v / r2v для Wan: поля media, например media, отбрасываются, а upstream Alibaba Cloud возвращает [InvalidParameter] Field required: input.media. Все запросы на создание видео Wan отправляются в /wan/api/v1/services/aigc/video-generation/video-synthesis, а запросы на получение всегда идут в /v1/tasks/{task_id}.Что делает заголовок X-DashScope-Async: enable? Он обязателен?
Что делает заголовок X-DashScope-Async: enable? Он обязателен?
current user api does not support synchronous calls. Запрос на получение (GET) этот заголовок не требует.Почему опрос идет через /v1/tasks/{id}, а не через /wan/api/v1/tasks/{id}?
Почему опрос идет через /v1/tasks/{id}, а не через /wan/api/v1/tasks/{id}?
/v1/tasks/{task_id}. Независимо от того, какой путь вы использовали для создания задачи, вы опрашиваете ее через этот единственный endpoint, а поля верхнего уровня ответа status / progress / result_url / error остаются согласованными.загрузка result_url возвращает 403 / SignatureDoesNotMatch, что делать?
загрузка result_url возвращает 403 / SignatureDoesNotMatch, что делать?
Authorization. result_url уже является предварительно подписанной прямой ссылкой Alibaba Cloud OSS; если добавить APIYI Key, OSS отклонит ее:Что если срок действия result_url истек?
Что если срок действия result_url истек?
/v1/tasks/{task_id}, и обычно вы получите свежую result_url, но срок действия опроса по самому task_id тоже составляет 24 часа (после этого возвращается UNKNOWN). Для долгосрочного хранения как можно скорее загрузите файл в свое хранилище.прогресс завис на 30% — он завис?
прогресс завис на 30% — он завис?
status все еще in_progress, продолжайте ждать; обычно он сразу прыгает с 30% до 100%.Сколько задач один Key может выполнять параллельно?
Сколько задач один Key может выполнять параллельно?
Тарифицируются ли неудачные задачи?
Тарифицируются ли неудачные задачи?
status=failed не тарифицируется. Но учтите: повторная отправка той же задачи тарифицируется снова, поэтому сделайте ее идемпотентной. Во время тестирования можно отключить prompt_extend и использовать 720P / 5 seconds / short prompts, чтобы снизить стоимость за единицу.Wan2.6 по-прежнему можно использовать?
Wan2.6 по-прежнему можно использовать?
wan2.6-r2v-flash) по-прежнему есть в списке доступных вызовов, с тем же протоколом, что и Wan2.7; достаточно изменить имя model. См. Исторические версии.Настройка группы
Серии Wan и HappyHorse используют одну группуWan&HappyHorse — один Token может вызывать обе серии. Видео-модели тарифицируются за секунду, поэтому Token должен соответствовать двум условиям, чтобы маршрутизация прошла успешно:
- Модель тарификации: выберите Pay-as-you-go Priority или Pay-as-you-go — видео тарифицируется за секунду, поэтому Token с Pay-per-request не может маршрутизироваться
- Группа: выберите группу, которая включает
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 (легко вычислить)
В консоли группаWan&HappyHorse показывает коэффициент 0.14x, который выражается во встроенной единице тарификации RMB. Поскольку APIYI ведет тарификацию в USD по фиксированному курсу 1:7, фактический пересчет такой:
Пересчет: цена в USD за секунду = официальная цена в RMB × 0.14 (то есть× 0.98 ÷ 7). Например, официальная цена 1080P в ¥1.0/s → $0.14/s, то есть ровно0.14x, который отображается в консоли.
Подробности цены (цена по умолчанию, тарификация по секундам)
Wan2.7 text-to-video / image-to-video / reference-to-video тарифицируются одинаково, с двумя уровнями —720P / 1080P (480P не поддерживается):
wan2.7-r2vпо умолчанию равен1080P, а длительность ограничена 10 секундами, если в reference media есть видео.wan2.7-videoedit(редактирование видео) формирует выходную длительность по исходному видео и тарифицируется по фактическим секундам результата, а не поduration.- Указанные цены — это цена по умолчанию (98% от официальной); с максимальным бонусом за пополнение эффективная цена примерно равна значению из таблицы ÷ 1.2 (например, 1080P 5 s $0.70 → примерно $0.58).
Ступенчатые бонусы за пополнение для еще более низкой эффективной цены
После подключения к программе бонусов за пополнение зачисленный баланс можно увеличить примерно до ~1.2x, еще сильнее снижая эффективную цену:- Единица тарификации = уровень разрешения × длительность (секунды); неудачные задачи не тарифицируются.
- 1:7 — это фиксированный расчетный курс обмена (не льготный); он единообразно применяется ко всем пополнениям в USD.
- Для самых высоких уровней бонусов и подходящих каналов см. бонусы за пополнение. Актуальный курс является приоритетным в консоли.
Связанные документы
Песочница Text-to-Video
wan2.7-t2v отладка в реальном времени + примеры кодаПесочница Image-to-Video
wan2.7-i2v первый кадр + управляющее аудиоПесочница Reference-to-Video
wan2.7-r2v многообъектный референс + голосПесочница Video Edit
wan2.7-videoedit замена одежды / фонаИсторические версии (Wan2.6)
Серия HappyHorse
help.aliyun.com/zh/model-studio/text-to-video-api-reference. По вопросам или предложениям, пожалуйста, откройте обращение в консоли APIYI.