Перейти к основному содержанию
Wan 2.7 и Wan 3.0 работают через асинхронные задачи в формате DashScope. Нужен токен из группы Wan, оплата идёт за секунды видео.
Не отправляйте запросы Wan на /v1/videos.
  • Задачам «изображение в видео», «видео по референсам» и редактированию видео нужно тело DashScope с input.media[].
  • Поэтому создавайте все задачи Wan через эндпоинт из таблицы выше.

Создание токена Wan

Модели Wan доступны только в группе Wan, поэтому токен должен принадлежать ей. Токены других групп, например default или SeeDance2, эти модели вызвать не могут: запрос завершится ошибкой «нет канала». Отдельный токен для Wan к тому же упрощает проверку журнала и списаний по моделям и задачам.

Оплата и цены

Видео Wan оплачивается посекундно по списочной цене Alibaba Cloud Model Studio плюс 20%. Надбавка покрывает налоги, конвертацию валют и трансграничные расчёты, эксплуатацию платформы и техническую поддержку. С 14 октября 2026 года цена пересчитывается так:
  • цена за секунду в долларах = списочная цена Alibaba Cloud за секунду в юанях × 0.1714 (множитель группы Wan)
  • при фиксированном курсе 1:7 получается 0.1714 × 7 ≈ 1.2, то есть вы платите около 1.2× от списочной цены
Суммы в журнале вызовов уже учитывают множитель, повторно его применять не нужно. Цены за секунду: Модели Wan 2.7 для текста в видео, изображения в видео, видео по референсам и редактирования видео (wan2.7-t2v, wan2.7-i2v, wan2.7-r2v и wan2.7-videoedit) стоят одинаково. Цены Alibaba Cloud указаны для региона China North 2 (Пекин) на странице цен Model Studio (на китайском). Как считаются оплачиваемые секунды:
  • Только выход (текст в видео, изображение в видео, только референсные изображения): секунды созданного видео.
  • С входным видео: секунды входа плюс секунды выхода — то же правило, что у Alibaba Cloud.
    • wan2.7-videoedit: исходное видео плюс результат. Если задать duration от 2 до 10 секунд, исходное видео обрезается с начала, и учитывается только обрезанная часть.
    • wan2.7-r2v с референсным видео: до 5 секунд референсного видео плюс результат.
    • Wan 3.0 с reference_video (референсы, редактирование или продление): все секунды входного видео плюс результат.
  • Без resolution: и Wan 2.7, и Wan 3.0 по умолчанию выдают 1080P и оплачиваются по цене 1080P.
Примеры стоимости:
  • wan2.7-i2v, 720P, 5 секунд: 5 × $0.1028 ≈ $0.51
  • wan3.0-video, 1080P, 10 секунд: 10 × $0.2057 ≈ $2.06
  • wan2.7-videoedit для 5-секундного ролика в 720P: (5 + 5) × $0.1028 ≈ $1.03
При создании задачи запрошенная длительность списывается заранее. Когда задача завершается, списание пересчитывается по секундам, которые сообщил Alibaba Cloud, и разница возвращается или доплачивается. Для задач Wan 3.0 с входным видео заранее списываются 30 секунд, а разница возвращается после завершения, поэтому баланса должно хватать на это удержание. Неудавшиеся задачи не оплачиваются, но одна и та же задача, отправленная дважды, оплачивается дважды. Связывайте собственный ID операции с каждым task_id и не делайте безусловных автоматических повторов. Фактическое списание по каждой задаче видно в журнале вызовов. Если за неудавшуюся задачу всё же есть списание, напишите в поддержку и укажите ID задачи. Стоимость определяют длительность и разрешение результата, поэтому передавайте duration и resolution явно и оценивайте стоимость по таблице до создания задачи. Модели Wan и их группа перечислены на странице Цены на API моделей ИИ.
Для коротких роликов около 720p со звуком MiniMax H3 стоит $0.25 за 5 секунд при 768P, а Видео Muse — $0.30 за 10 секунд; для обеих моделей хватает токена группы default. Все модели сравниваются в разделе Сравнение API видео.

Как работает задача Wan

1

Создайте задачу

Отправьте POST /wan/api/v1/services/aigc/video-generation/video-synthesis с телом JSON и заголовком X-DashScope-Async: enable. Сохраните output.task_id из ответа.
2

Опрашивайте задачу

Отправляйте GET /v1/tasks/{task_id} каждые 5–10 секунд. Решения принимайте по полю status верхнего уровня, а не по вложенным полям исходного ответа модели.
3

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

Когда status станет completed, скачайте MP4 по result_url верхнего уровня. Это подписанная ссылка на объектное хранилище, поэтому не передавайте с ней заголовок Authorization от LaoZhang API.
Полные правила запросов, статусы задач и описание полей идут после примеров, начиная с раздела «Эндпоинты и правила запросов».

Подготовка окружения

В примерах для оболочки используются curl и jq (установить jq можно командой brew install jq или sudo apt-get install jq). Задайте ключ и базовый URL один раз:
Каждый пример создания ниже сохраняет ответ в create.json, который затем читает шаг из раздела «Опрос задачи и скачивание видео».

Текст в видео

В ответе на создание ID задачи находится в output.task_id:
Если в ответе нет output.task_id, прочитайте сообщение об ошибке в create.json и сверьтесь с таблицей в разделе «Устранение неполадок».

Изображение в видео

driving_audio необязателен. Alibaba Cloud использует аудио, чтобы управлять видео, например синхронизировать губы или движения с ритмом, как в примере с рэпом выше. Аудио работает только вместе с изображением first_frame и, как и остальные медиафайлы, должно быть доступно по публичному HTTPS-URL. Допустимые форматы, длительность и размер аудиофайла описаны в справочнике API Wan 2.7 «изображение в видео» Alibaba Cloud (на китайском).

Видео по референсам

Редактирование видео

Генерация видео Wan 3.0

Wan 3.0 не делит задачи по разным ID моделей. Одна модель читает элементы input.media[] и сама определяет, что нужно: текст в видео, изображение в видео, видео по референсам или редактирование видео. Возможности у двух моделей одинаковые:
  • wan3.0-video — стандартная модель;
  • wan3.0-video-prime — более быстрая модель с более высокой ценой за секунду.
Обе используют тот же эндпоинт создания, а опрос и скачивание работают так же, как у Wan 2.7. В промптах для видео по референсам можно ссылаться на входные данные как «image 1», «video 1» или «audio 1» (图1, 视频1, 音频1); нумерация идёт по порядку среди входных данных одного типа. Некоторые поля parameters работают иначе, чем в Wan 2.7: Минимальный запрос «текст в видео»:
Чтобы изменить стиль готового ролика, передайте его как reference_video. В оплачиваемые секунды входит и входное видео (см. раздел «Оплата и цены»).
Как и раньше, возьмите TASK_ID из create.json, затем опросите задачу и скачайте видео, как описано в следующем разделе. Другие типы входных данных, например документ (file) или веб-страница (link), описаны в справочнике API генерации видео Wan3.0 Alibaba Cloud (на китайском).

Опрос задачи и скачивание видео

Возьмите ID задачи из create.json и проверьте задачу:
Повторяйте запрос каждые 5–10 секунд, пока status не перестанет быть submitted или in_progress. Завершённая задача выглядит так. Опирайтесь на поля верхнего уровня status и result_url:
Скачивайте видео без заголовка Authorization. result_url — подписанная ссылка на объектное хранилище, и лишний заголовок аутентификации может привести к ошибке 403.

Клиент на Python

Клиент использует только стандартную библиотеку Python (Python 3.8 и новее). Он создаёт задачу «текст в видео», опрашивает её до 20 минут и сохраняет MP4.

Эндпоинты и правила запросов

Статусы задачи

Принимайте решения по полю status верхнего уровня, которое возвращает GET /v1/tasks/{task_id}: В ответе на создание есть и output.task_status — исходное состояние DashScope, у новой задачи обычно PENDING. Используйте его только для того, чтобы убедиться, что задача принята, а дальше ориентируйтесь на status верхнего уровня из GET /v1/tasks/{task_id}. Продолжайте опрос, только пока статус равен submitted или in_progress. Любое другое значение считайте конечным — например, если задача отменена или вы запрашиваете её позже чем через 24 часа. Так неожиданное состояние не заставит клиент опрашивать задачу бесконечно. Прогресс у Wan грубый: progress может долго стоять на 30%, а затем сразу перескочить на 100%.

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

Модели Wan 2.6 (wan2.6-t2v, wan2.6-i2v, wan2.6-r2v и wan2.6-r2v-flash) выведены 14 октября 2026 года. Если вы ещё их вызываете, перейдите на соответствующую модель Wan 2.7 или на Wan 3.0. ID моделей взяты из публичного прайс-листа LaoZhang API на 14 октября 2026 года. wan2.7-image-pro — модель изображений, с этим видео-эндпоинтом она не работает.

Тело запроса

Допустимые значения у моделей разные. Диапазоны выше взяты из справочника API «текст в видео» Alibaba Cloud. Для остальных моделей смотрите справочник Alibaba Cloud по нужной модели (на китайском):

Медиаданные на входе

Каждый url медиафайла должен быть публичной HTTPS-ссылкой, которую Alibaba Cloud может скачать напрямую. Ссылки за входом в аккаунт или cookie, адреса частных сетей и ссылки, которые истекают раньше запуска задачи, могут привести к её сбою.

Советы для рабочей среды

  • Сначала сохраните ID задачи. Записывайте output.task_id вместе с собственным ID операции сразу после ответа на создание: тогда перезапущенный обработчик продолжит опрос, а не создаст дубликат.
  • Проверяйте, прежде чем повторять создание. Каждый принятый запрос на создание запускает отдельную задачу. Если запрос на создание завершился таймаутом, сверьтесь со своими записями и журналом вызовов, прежде чем отправлять его снова.
  • Ограничивайте опрос. Проверяйте каждые 5–10 секунд, останавливайтесь через 20 минут и считайте конечным любой статус, кроме submitted и in_progress.
  • Скачивайте сразу. Alibaba Cloud хранит ID задачи и ссылку на видео 24 часа. Копируйте MP4 в своё хранилище и отдавайте пользователям собственную ссылку, а не подписанную.
  • Держите входные данные доступными. Размещайте медиафайлы по публичным HTTPS-ссылкам, которые работают до завершения задачи.
  • Контролируйте стоимость. Задавайте duration и resolution явно и проверяйте списание по каждой задаче в журнале вызовов.
  • Один токен на приложение. Отдельный токен группы Wan для каждого приложения или окружения упрощает проверку журнала и списаний.

Устранение неполадок

Частые вопросы

Сколько стоит 5-секундное видео?

По ценам, действующим с 14 октября 2026 года, для задачи, которая только выводит видео:
  • wan3.0-video: около $0.51 при 720P и $1.03 при 1080P
  • wan3.0-video-prime: около $0.77 при 720P и $1.54 при 1080P
  • Wan 2.7: около $0.51 при 720P и $0.86 при 1080P
Стоимость растёт вместе с длительностью, так что 10 секунд стоят примерно вдвое больше. Без resolution задача оплачивается по цене 1080P, а к задачам с входным видео добавляются входные секунды (см. раздел «Оплата и цены»).

Обязательно ли передавать X-DashScope-Async: enable?

Да, в каждом запросе на создание. HTTP API Wan работает только асинхронно, и POST на создание без этого заголовка завершается ошибкой current user api does not support synchronous calls. Для опроса GET /v1/tasks/{task_id} и скачивания по result_url заголовок не нужен.

Что получится, если не передать resolution и duration?

Вы получите видео 1080P. Согласно справочникам API Alibaba Cloud, все четыре модели Wan 2.7 (wan2.7-t2v, wan2.7-i2v, wan2.7-r2v и wan2.7-videoedit) и Wan 3.0 по умолчанию выдают 1080P:
  • Текст в видео, изображение в видео и видео по референсам по умолчанию длятся 5 секунд.
  • Редактирование видео в Wan 2.7 сохраняет длительность исходного видео.
Поэтому задача «текст в видео» без параметров оплачивается как 5 секунд в 1080P:
  • Wan 2.7: около $0.86
  • wan3.0-video: около $1.03
  • wan3.0-video-prime: около $1.54
Примеры на этой странице явно задают 720P. Чтобы стоимость была предсказуемой, задавайте resolution и duration в каждом запросе и оценивайте цену по разделу «Оплата и цены».

Как сделать вертикальное или квадратное видео?

Для текста в видео и видео по референсам задайте parameters.ratio; остальные задачи повторяют форму входных данных:
  • Текст в видео и видео по референсам: одно из соотношений ниже.
    • 16:9 (по умолчанию)
    • 9:16 (например, при 720P получится видео 720×1280)
    • 1:1
    • 4:3
    • 3:4
  • Изображение в видео: ratio не принимает и повторяет форму первого кадра.
  • Редактирование видео: сохраняет форму исходного видео, если не задать ratio.
  • Wan 3.0: по умолчанию adaptive (соотношение выбирается по входным данным), дополнительно принимает 21:9.
Цена зависит только от уровня разрешения и секунд результата, поэтому горизонтальное, вертикальное и квадратное видео при одном уровне стоят одинаково. Допустимые значения по моделям — в справочнике API «текст в видео» Alibaba Cloud (на китайском).

Есть ли в видео звук и можно ли озвучить персонажа своим аудио?

Да, и то и другое. По данным Alibaba Cloud, Wan 2.7 по умолчанию выдаёт видео со звуком: модель создаёт фоновую музыку, звуковые эффекты или голоса под картинку. Чтобы синхронизировать движение губ со своим аудио, используйте wan2.7-i2v и добавьте элемент driving_audio в input.media[], как в разделе «Изображение в видео». Аудио должно быть в формате WAV или MP3 длиной 2–30 секунд; всё, что длиннее duration, обрезается. Wan 3.0 тоже по умолчанию выдаёт звук. Для беззвучного видео передайте "audio": false, цена от этого не меняется. Видео по референсам может повторно использовать голос из референсного видео, а редактирование видео — сохранить исходный звук. Нужные параметры описаны в справочниках API Wan 2.7 «видео по референсам» и «редактирование видео» (оба на китайском).

Как убрать водяной знак «AI 生成»?

Передайте "watermark": false в parameters или вообще не передавайте watermark: по умолчанию Alibaba Cloud водяной знак не добавляет. Примеры на этой странице передают true, поэтому в их видео водяной знак стоит в правом нижнем углу; перед использованием примеров в рабочей среде измените это значение.

Можно ли отправить задачу заново после таймаута или ошибки?

Сначала проверьте задачу. Таймаут на стороне клиента не означает, что задача не выполнена: продолжайте опрашивать тот же task_id до 24 часов, потому что новый запрос на создание запустит вторую задачу и будет оплачен ещё раз. Создавайте новую задачу только после того, как status станет failed или другим конечным значением, и сначала исправьте запрос. Неудавшиеся задачи не оплачиваются, а фактическое списание по каждой задаче видно в журнале вызовов. Подробнее — в разделах «Оплата и цены» и «Статусы задачи».

Почему у одной задачи две строки списания в журнале вызовов?

Запрошенная длительность списывается при создании задачи, а при завершении проводится расчёт:
  • Если Alibaba Cloud сообщает то же число секунд, в журнале одна строка списания.
  • Если секунды отличаются, вторая строка («Wan 任务完成,按实际时长调整») возвращает или доплачивает разницу.
Обычно причина — входное видео, секунды которого тоже оплачиваются. Для задач Wan 3.0 с входным видео заранее списываются 30 секунд, а разница возвращается после завершения. Реальная стоимость задачи — сумма двух строк (см. раздел «Оплата и цены»).

Задача зависла, если progress стоит на 30%?

Нет. Сервис модели сообщает прогресс крупными шагами, поэтому остановка на 30% — это нормально. Продолжайте опрос, пока status верхнего уровня равен in_progress (см. раздел «Статусы задачи»).

Связанные материалы