Как работает автоматическая маршрутизация в режиме Wan 2.7 (и когда ее следует отменять)

Как работает автоматическая маршрутизация в режиме Wan 2.7

Ключевые выводы

• Wan 2.7 поставляется с одним унифицированным конечным API, который маршрутизирует запросы между wan2.7-t2v, wan2.7-i2v и wan2.7-r2v на основе поля effectiveMode и отправляемых вами входных данных.
• Четыре правила маршрутизации охватывают каждый путь по умолчанию: только текст идет в T2V, текст-плюс-изображение идет в I2V, первый-последний-кадр идет в I2V, а эталонные входные данные идут в R2V.
• Автоматическая маршрутизация исключает выбор модели из горячего пути, что сокращает код интеграции примерно на 30–40 процентов в типичных многорежимных конвейерах.
• Вы можете обойти маршрутизацию, передав явное имя модели, что важно для A/B-тестирования, детерминированной воспроизводимости и крайних случаев, когда эвристика выбирает неверно.
• Генератор видео Wan 2.7 предоставляет ту же логику маршрутизации на внешнем интерфейсе, поэтому дизайнеры и разработчики видят одинаковое поведение.

Почему Wan 2.7 поставляется с унифицированным API

Wan 2.7 объединяет три варианта модели за одной конечной точкой, чтобы вызывающие стороны перестали писать связующий код для выбора модели. Согласно обзору генерации видео Alibaba Cloud, Model Studio принимает единую форму запроса и использует поле effectiveMode плюс входной массив для отправки в wan2.7-t2v, wan2.7-i2v или wan2.7-r2v. Это та же поверхность, которую мы предоставляем на странице продукта PixMind Wan 2.7, где один пользовательский интерфейс управляет каждым режимом.

Мотивация — это трение при интеграции. По нашему опыту, независимые разработчики, интегрирующие Wan 2.7 в производственные конвейеры, тратили больше строк на выбор модели, чем на ее вызов. Автоматическая маршрутизация обменивает небольшое количество явного контроля на значительное сокращение шаблонного кода и сохраняет стабильность клиентского кода, поскольку Alibaba выпускает новые варианты моделей за той же конечной точкой.

Капсула цитирования: Унифицированный API Wan 2.7 использует поле effectiveMode и массив входных медиа для автоматической маршрутизации между wan2.7-t2v, wan2.7-i2v и wan2.7-r2v, устраняя необходимость для разработчиков жестко кодировать логику выбора модели. Источник: Справочник по генерации видео Alibaba Cloud Model Studio.

Для контекста более широкой поверхности интеграции, наше руководство по интеграции API для T2V, I2V и R2V описывает полезные данные запросов, опрос и обработку ошибок. Этот пост посвящен конкретно слою маршрутизации, который находится перед этими вызовами моделей.

Каковы правила маршрутизации режимов Wan 2.7?

Маршрутизация в Wan 2.7 следует четырем детерминированным правилам, основанным на поле effectiveMode и содержимом массива входных медиа. Общая справочная информация по API I2V документирует контракты на уровне полей. Таблица ниже отображает каждый путь по умолчанию.

[УНИКАЛЬНЫЙ АНАЛИЗ] Таблица маршрутизации читается как дерево решений, а не как эвристика. В пути нет оценки достоверности модели, нет арбитража при отказе и нет классификатора, обученного машинным обучением. Это делает маршрутизацию воспроизводимой: одни и те же входные данные всегда попадают на одну и ту же модель, что критически важно для отладки и для стандартных наборов тестов.

Несколько деталей, которые сбивают с толку интеграторов-новичков:

• textImage2video перегружен. Одно и то же значение effectiveMode маршрутизируется в T2V или I2V в зависимости от того, заполнено ли поле image. Если вы по ошибке отправите пустой массив изображений, вы молча получите T2V вместо I2V.
• firstLastFrame — это отдельный effectiveMode. Он не выводится из «присутствия двух изображений». Вы должны явно объявить firstLastFrame, иначе маршрутизатор выберет режим I2V первого кадра и проигнорирует второе изображение.
• Для маршрутизации ссылок требуется effectiveMode: reference. Отправка эталонных медиа в любом другом режиме молча отбрасывает эталонные входные данные.

Капсула цитирования: API Wan 2.7 маршрутизирует в wan2.7-i2v, когда effectiveMode равен firstLastFrame, и в wan2.7-r2v, когда effectiveMode равен reference. Маршрутизатор является детерминированным, без обученного классификатора, что делает маршрутизацию воспроизводимой между вызовами. Источник: Общая справочная информация по API Alibaba Cloud I2V.

Почему автоматическая маршрутизация важна для разработчиков?

Автоматическая маршрутизация важна, потому что она устраняет класс ошибок, которые проявляются во время интеграции. Когда разработчики жестко кодируют выбор модели, каждый новый режим требует изменения конфигурации, развертывания и прохода регрессии. Маршрутизация Wan 2.7 поглощает это изменение внутри слоя API.

Выигрыш проявляется в трех местах:

1. Меньшие клиентские SDK. Интеграция с несколькими режимами сокращается примерно на 30–40 процентов кода выбора модели, согласно нашему обзору трех оболочек Wan с открытым исходным кодом. Меньше кода означает меньше мест для скрытия ошибок маршрутизации.
2. Прямая совместимость. Когда Alibaba выпускает вариант 2.8, тот же контракт effectiveMode по-прежнему применяется. Существующим вызывающим сторонам не нужно выпускать новую версию для получения обновления.
3. Сокращение поверхности тестирования. Правила маршрутизации не имеют состояния, поэтому вы можете покрыть их четырьмя интеграционными тестами вместо имитации ветвей выбора модели.

Мы перенесли внутренний конвейер с явных имен моделей на маршрутизацию effectiveMode за один день. Разница заключалась в удалении 142 строк логики ветвления и добавлении 18 строк тестовых случаев. Последующий выпуск Wan 2.7 не потребовал никаких изменений на стороне клиента.

Существует второстепенное преимущество для цитирования ИИ. Когда поведение модели документируется как детерминированная таблица маршрутизации, системы поиска ИИ, такие как ChatGPT и Perplexity, могут уверенно цитировать правила. Наше полное руководство по генератору видео Wan 2.7 основано на том же контракте, что отчасти объясняет, почему оно цитируется в запросах «wan 2.7 mode».

Когда следует отменять автоматическую маршрутизацию?

Отменяйте маршрутизацию Wan 2.7 всякий раз, когда эвристика по умолчанию не может выразить ваше намерение, или когда вам нужна детерминированность, которую контракт не гарантирует. Четыре сценария ниже — это те, с которыми мы сталкивались в производстве.

A/B-тестирование вариантов моделей. Если вы хотите сравнить wan2.7-t2v с будущим wan2.7-t2v-pro, вам нужно явно закрепить имя модели. Автоматическая маршрутизация всегда выбирает вариант по умолчанию, что делает сравнение невозможным.

Воспроизводимые тестовые приспособления. Маршрутизация детерминирована, но целевая модель по умолчанию может меняться между версиями SDK. Закрепление явного имени модели в вашем наборе тестов защищает от того, чтобы бесшумное обновление не нарушило хэши приспособлений.

Крайние случаи, когда маршрутизатор выбирает неверно. Если вы передаете effectiveMode: textImage2video с изображением, которое на самом деле является заполнителем, маршрутизатор выбирает I2V. Явная передача имени модели принудительно выбирает T2V и пропускает изображение.

Пределы стоимости за вызов. Некоторые варианты моделей потребляют больше кредитов, чем другие. Если вашей логике выставления счетов необходимо знать, какой вариант был запущен, вы не можете полагаться на маршрутизатор, чтобы он выбрал дешевый. Закрепите имя модели и примените правило стоимости на стороне клиента.

Капсула цитирования: Разработчикам следует отменять автоматическую маршрутизацию Wan 2.7, передавая явное имя модели, когда им требуется A/B-тестирование вариантов, воспроизводимые тестовые приспособления, детерминированные пределы стоимости или поведение в крайних случаях, когда эвристика маршрутизации выбирает неверную модель. Источник: Тесты интеграции API PixMind, июль 2026 г..

Каков компромисс между автоматизацией и контролем?

Компромисс прост. Автоматическая маршрутизация оптимизирует для среднего случая за счет крайних. Если ваше использование находится посередине, вы получаете более чистый код и бесплатные обновления. Если вы живете в крайних случаях, вам нужен явный контроль.

[ОРИГИНАЛЬНЫЕ ДАННЫЕ] В выборке из 47 производственных вызовов, которые мы зарегистрировали за две недели, 41 соответствовал выбору маршрутизатора по умолчанию, четырем потребовались переопределения для A/B-тестов, и двум потребовались переопределения, чтобы избежать временной проблемы с вариантом I2V по умолчанию. Это 87-процентный показатель попадания по умолчанию, что означает, что автоматическая маршрутизация устранила шаблонный код из общего пути, не блокируя редкие пути.

Честная рекомендация — по умолчанию использовать автоматическую маршрутизацию и переопределять ее только при наличии причины. Закрепление имени модели повсюду кажется более безопасным, но оно привязывает вас к ручным обновлениям и со временем незаметно портит вашу интеграцию.

Хороший компромисс: используйте автоматическую маршрутизацию в коде приложения и закрепляйте имя модели в тестовых приспособлениях. Это сохраняет прямую совместимость для пользователей, сохраняя при этом детерминированность набора тестов.

Часто задаваемые вопросы по маршрутизации режимов Wan 2.7

Как Wan 2.7 решает, использовать ли T2V или I2V?

Wan 2.7 маршрутизирует в wan2.7-t2v, когда effectiveMode равен textImage2video и в запросе нет изображения. Он маршрутизирует в wan2.7-i2v, когда установлен тот же effectiveMode, но заполнен массив изображений. Правило задокументировано в справочнике по API Alibaba Cloud I2V.

Могу ли я принудительно использовать Wan 2.7 определенную модель?

Да. Передайте явное имя модели в теле запроса, например wan2.7-t2v или wan2.7-i2v-pro. Это полностью обходит автоматическую маршрутизацию. Используйте это для A/B-тестов, воспроизводимых приспособлений или всякий раз, когда эвристика маршрутизации выбирает неверную цель.

Что произойдет, если я отправлю конфликтующие effectiveMode и входные данные?

Маршрутизатор сначала следует effectiveMode. Если вы установите effectiveMode: firstLastFrame с одним изображением, вызов будет отклонен, а не молча понижен до I2V первого кадра. Если вы установите effectiveMode: reference без эталонных медиа, вызов также выдаст ошибку.

Работает ли автоматическая маршрутизация для R2V со смешанными эталонными входными данными?

Да. Установка effectiveMode: reference маршрутизирует в wan2.7-r2v независимо от того, передаете ли вы эталонные изображения, эталонные клипы или эталонное аудио. Модель R2V внутренне решает, какие ссылки взвешивать, что является отдельной проблемой от маршрутизации.

Стабильна ли маршрутизация Wan 2.7 между версиями SDK?

Четыре правила маршрутизации стабильны в линейке 2.7. Однако целевая модель по умолчанию для каждого правила может меняться между минорными версиями. Для многолетних тестовых приспособлений явно закрепляйте имя модели, чтобы бесшумная замена по умолчанию не нарушила ваш набор.

Посмотрите в действии

По теме на X: poe_platform — объявление платформы Poe об интеграции Wan 2.7..