Skip to main content

Обзор

Wan3.0 — это универсальная модель для генерации видео от Tongyi Wanxiang. В отличие от Wan2.7, где требовалось переключаться между четырьмя ID моделей (t2v / i2v / r2v / videoedit), Wan3.0 поддерживает все режимы через один ID модели — выполняемая задача определяется тем, какие медиафайлы вы передаете. Генерация видео по тексту, по изображению, по референсу и редактирование видео используют единое тело запроса. Две версии с одинаковыми возможностями, но разной скоростью и стоимостью:
Обе версии используют абсолютно одинаковые параметры, эндпоинт и правила обработки медиа — различаются только скорость и цена за единицу. Сначала выполните интеграцию с wan3.0-video, а затем переведите чувствительный к задержкам продакшн-трафик на wan3.0-video-prime.

Что изменилось по сравнению с Wan2.7

Wan2.7 по-прежнему полностью доступна — см. Генерация видео Wan2.7.

Ключевые особенности

Четыре режима, одна модель

Режимы «текст в видео» (text-to-video), «изображение в видео» (image-to-video, первый/последний кадр), «референс в видео» (изображение, видео, аудио) и редактирование видео используют один и тот же ID модели и единый эндпоинт, различаясь параметром type в input.media[].

До 30 секунд

До 30 секунд на один запрос (входное референсное видео + итоговый результат суммарно) — вдвое больше 15 секунд у Wan2.7, чего достаточно для полноценного фрагмента с закадровым голосом или сцены короткометражной драмы.

Встроенное аудио

Результат по умолчанию содержит дорожку soun, управляющее аудио не требуется. Используйте reference_audio, когда необходим конкретный тембр голоса.

Три уровня разрешения

Новый уровень 480P стоит вчетверо дешевле 1080P — создавайте черновые варианты с минимальными затратами, а затем выполняйте апскейл для финального рендеринга.

Настройка группы

Wan3.0 использует общую группу Wan&HappyHorse с Wan2.7 и HappyHorse — один ключ вызывает их все. Видео тарифицируется посекундно, поэтому для успешной маршрутизации ваш ключ должен соответствовать двум условиям:
  1. Режим тарификации: выберите «Pay-as-you-go priority» или «Pay-as-you-go» — видео с посекундной тарификацией не может маршрутизироваться через ключ с оплатой за вызов
  2. Группа: включите Wan&HappyHorse
Экран создания token: режим тарификации установлен на Pay-as-you-go priority, в выпадающем списке групп выбрано Wan&HappyHorse (0.14x)

Create a key: set billing mode to pay-as-you-go priority and select the Wan&HappyHorse group (0.14x) to call every Wan3.0 / Wan2.7 / HappyHorse video model (the screenshot shows the old group name Wan)

Тарифы

По умолчанию 98% от официальной цены Alibaba — вплоть до 81,7% с максимальным бонусом за пополнение. Это дает $0.0245/сек (≈ ¥0,17/сек) для 480P и $0.049/сек (≈ ¥0,34/сек) для 720P в wan3.0-video.

Как формируется тариф: 0.98x по умолчанию, вплоть до 0.817x с бонусами

В консоли для группы Wan&HappyHorse отображается коэффициент тарифа 0.14x с номиналом в CNY. APIYI производит расчеты в USD по фиксированному курсу 1:7:
Таким образом, цена за секунду в APIYI (USD) = официальная цена Alibaba в CNY за секунду × 0.14, что составляет 98% от официального тарифа.

Таблица 1: Подробные тарифы APIYI (посекундная тарификация)

«С бонусом 10% / 20%» — это эффективная цена за единицу с учетом того, что бонус за пополнение увеличивает зачисляемый баланс; при этом за каждый вызов списывается цена по умолчанию.

Таблица 2: Сравнение уровней с официальными ценами Alibaba

Для wan3.0-video в настоящее время действует официальная временная скидка 30% (применяется ко всем пользователям по умолчанию), и цены APIYI рассчитываются с учетом этой скидки. Для wan3.0-video-prime скидка не предусмотрена. Цены APIYI будут скорректированы после окончания акции.

Таблица 3: Итоговая стоимость для популярной продолжительности

Суммирование бонусов за пополнение

Благодаря бонусу за пополнение зачисляемый баланс увеличивается до ~1.2x, что делает эффективную ставку еще ниже:
1:7 — это фиксированный расчетный курс (а не промо-курс), который действует для всех пополнений в USD.
Цены соответствуют официальным тарифам провайдера и могут изменяться вслед за ними; таблица выше приведена исключительно для справки, а актуальные данные представлены на вкладке Цены на модели в верхнем меню навигации: Цены на модели.

⚠️ Правила тарификации (отличаются от других видеомоделей)

Оплачиваемые секунды = длительность входного референсного видео + длительность выходного видео. Согласно Alibaba: «Как входное, так и выходное видео тарифицируются по длительности; цена за единицу определяется разрешением выходного видео».
Чтобы снизить затраты, обрежьте референсное видео — уменьшение duration никак не влияет на секунды входного видео. Пример: 10-секундный референс плюс 2-секундный вывод тарифицируются как 12 секунд; обрезка референса до 3 секунд тарифицируется всего как 5 секунд.

Преавторизация и расчет

  • Без референсного видео: запрашиваемый duration списывается сразу, и это окончательная сумма — отдельной записи расчета нет.
  • С референсным видео: в момент отправки шлюз еще не знает длительность вашего входного видео, поэтому выполняет преавторизацию по лимиту в 30 секунд, затем пересчитывает стоимость по фактически оплаченным секундам и возвращает разницу (отдельная отрицательная запись в вашем счете).
Удержание по максимальному лимиту временно замораживает большую сумму: $0.147 для 480P, $0.294 для 720P, $0.588 для 1080P (wan3.0-video, 30 секунд). Поддерживайте достаточный баланс; возврат поступает в течение нескольких секунд после завершения задачи.

⚠️ Выбор эндпоинта (самое важное)

APIYI предоставляет два пути, но полноценно с Wan3.0 работает только сквозной эндпоинт DashScope:
Игнорируйте любые инструкции и примеры, в которых задачи генерации видео Wan отправляются на /v1/videos. Этот путь отбрасывает поле media, игнорирует параметры разрешения и длительности, а также приводит к завышенным списаниям. Всегда отправляйте запросы к Wan3.0 на /wan/api/v1/...video-synthesis.

Асинхронный рабочий процесс

1

Создание задачи

POST /wan/api/v1/services/aigc/video-generation/video-synthesis с заголовком X-DashScope-Async: enable. Сразу возвращает task_id.
2

Опрос статуса

GET /v1/tasks/{task_id} (с Authorization) каждые 5–10 секунд (ни в коем случае не менее 3), пока status не станет completed.
3

Скачивание видео

Выполните GET-запрос напрямую по result_url из ответа — без заголовка Authorization (это подписанная ссылка OSS; передача данных аутентификации вернет 403). Ссылка действительна в течение 24 часов.

Состояния задач

Финальными значениями являются completed / failed, а не нативные SUCCEEDED / FAILED от DashScope. Код, написанный под нативное перечисление, будет выполнять опрос бесконечно.
Недопустимые параметры также сначала возвращают HTTP 200 и завершаются ошибкой асинхронно — а не синхронным кодом 400. Недоступный URL медиафайла или суммарная длительность входных и выходных данных более 30 секунд проявятся только тогда, когда при опросе будет достигнуто финальное состояние. Никогда не полагайтесь только на код статуса при отправке.

Полный клиент на Python

Справочник параметров

Тело запроса использует вложенную структуру DashScope: { model, input: { prompt, media[] }, parameters: {...} }.

Поля input

Типы media[] и выбираемый ими режим

first_frame / last_frame нельзя совмещать с reference_* / file / link — эти два семейства ассетов взаимоисключающие, их совмещение отклоняется на стороне апстрима.
Каждый медиаобъект должен содержать как минимум type и url. Параметр url должен быть общедоступной https-ссылкой (предварительно загрузите локальные файлы в OSS / CDN и сохраняйте к ним доступ до завершения задачи).

Поля parameters

duration должно быть целым числом (5, а не "5"), а resolution надежнее указывать в верхнем регистре (720P).

Выбор: Wan3.0 / Wan2.7 / HappyHorse

Лучшие практики

480P стоит вчетверо дешевле, чем 1080P. Отработайте prompt и движение камеры с минимальными затратами: по цене одного 5-секундного рендера в 1080P можно получить четыре черновых варианта.
Секунды входящего видео тарифицируются. Если вам нужны только 3 секунды клипа, не загружайте 30-секундный оригинал — это самая распространенная ловушка лишних расходов в Wan3.0.
Видеомодели лучше всего реагируют на формулу «кто что делает и как движется камера». Описание «Рыжий кот потягивается на подоконнике, медленный наезд камеры» сработает гораздо лучше, чем «милый рыжий кот, солнечный свет, высокое разрешение».
Фактическое время генерации 5-секундного ролика: ~100 с для 480P, ~120 с для 720P, ~170 с для 1080P. Опроса раз в 5–10 секунд более чем достаточно.
За неудачные задачи средства возвращаются в полном объеме, но повторная отправка тарифицируется заново. При ошибках модерации измените prompt; при ошибках с ресурсами сначала проверьте доступность URL.

Часто задаваемые вопросы

Тарифицируемые секунды = длительность входного референсного видео + длительность выходного видео. Референс длительностью 10 секунд с выходным видео в 2 секунды тарифицируется как 12 секунд. Референсные изображения, аудио и файлы бесплатны.
Для задач с референсным видео выполняется предварительное холдирование средств с расчетом на максимальный лимит в 30 секунд, затем происходит расчет по фактически тарифицируемым секундам и возврат разницы. В детализации счета вы увидите запись с отрицательной корректировкой.
Это приблизительная оценка от вышестоящего сервиса, а не зависание. Обработка видео в 1080P или длинных роликов может занимать 3–5 минут. Продолжайте опрос.
Не передавайте заголовок Authorization — это подписанная ссылка OSS. Срок действия ссылок истекает через 24 часа, поэтому своевременно переносите файлы к себе.
Ошибки параметров и файлов ресурсов приводят к асинхронному сбою, а не к синхронной ошибке 400. Распространенные причины: недоступный URL медиафайла (включая истекшие подписанные ссылки), суммарная длительность входа и выхода более 30 секунд, модерация контента. Задачи с ошибкой возвращаются в полном объеме.
Убедитесь, что для вашего ключа выбран режим тарификации pay-as-you-go (ключи с тарификацией за вызов не могут маршрутизировать видеомодели), а его группа включает Wan&HappyHorse.

Связанная документация

Справочник по API генерации видео

Интерактивный Playground и примеры для cURL / Python / Node

Генерация видео Wan2.7

Предыдущее поколение из четырех моделей с синхронизацией губ по аудио

Генерация видео HappyHorse

Другая серия видео в той же группе

Тарифы на модели

Официальная сводная таблица цен по всему сайту
Официальные источники: help.aliyun.com/zh/model-studio/wan3-video-generation-guide, help.aliyun.com/zh/model-studio/wan3-video-generation-api-reference