Обзор
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
Поиск / загрузка асинхронных задач
Поручите интеграцию AI-агенту
Скопируйте этот prompt и вставьте его в Codex / Claude Code / Cursor
Сначала он загружает текстовую версию этой страницы (добавьте .md к любому URL документации), а затем пишет код под стек вашего проекта — асинхронный опрос, почему нельзя использовать /v1/videos, ошибка отсутствия X-DashScope-Async и правило целочисленного duration уже включены в требования.
Интегрируйте / выполните отладку генерации видео с помощью Wan2.7 (text-to-video, image-to-video, reference-to-video, редактирование видео) в этом проекте.
Прочитайте документацию перед тем, как писать код: загрузите https://docs.apiyi.com/en/api-capabilities/wan/overview.md для получения текстовой версии этой страницы. У каждой из четырёх возможностей есть собственная страница (text-to …
- Эндпоинт и асинхронный заголовок (две вещи, которые с наибольшей вероятностью заблокируют вас сразу): отправка запросов должна выполняться на …
Всего 10 требований. Используйте кнопку ниже, чтобы скопировать prompt целиком.
От каких проблем избавляет этот prompt
От каких проблем избавляет этот prompt
Почему использовать 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/с → $0.14/с, что в точности соответствует0.14x, отображаемому в консоли.
Подробные тарифы (базовая цена, тарификация посекундная)
Генерация Wan2.7 text-to-video / image-to-video / reference-to-video тарифицируется одинаково по двум уровням —720P / 1080P (480P не поддерживается):
wan2.7-r2vпо умолчанию имеет значение1080P, а длительность ограничена 10 секундами, если среди референсных медиафайлов присутствует видео.- Длительность результата для
wan2.7-videoedit(редактирование видео) соответствует исходному видео и тарифицируется по фактическим секундам результата, а не поduration. - Указанные цены являются базовыми (98% от официальной); с максимальным бонусом за пополнение фактическая цена составляет примерно значение из таблицы ÷ 1.2 (например, 1080P 5 с: $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.