Jak działa automatyczne routowanie w trybie Wan 2.7 (i kiedy je nadpisać)

Jak działa automatyczne routowanie w trybie Wan 2.7

Kluczowe wnioski

• Wan 2.7 dostarcza jeden zunifikowany punkt końcowy API, który routuje między wan2.7-t2v, wan2.7-i2v i wan2.7-r2v na podstawie pola effectiveMode i wysyłanych danych wejściowych.
• Cztery reguły routingu obejmują każdą domyślną ścieżkę: tylko tekst trafia do T2V, tekst plus obraz trafia do I2V, pierwsza-ostatnia klatka trafia do I2V, a dane referencyjne trafiają do R2V.
• Automatyczne routowanie usuwa wybór modelu z gorącej ścieżki, co zmniejsza kod integracyjny o szacunkowo 30 do 40 procent w typowych potokach wielotrybowych.
• Możesz pominąć routowanie, przekazując jawną nazwę modelu, co ma znaczenie dla testów A/B, deterministycznej odtwarzalności i przypadków brzegowych, w których heurystyka wybiera błędnie.
• Generator wideo Wan 2.7 udostępnia tę samą logikę routingu na front-endzie, dzięki czemu projektanci i deweloperzy widzą identyczne zachowanie.

Dlaczego Wan 2.7 dostarcza zunifikowane API

Wan 2.7 łączy trzy warianty modeli za jednym punktem końcowym, aby wywołujący przestali pisać kod łączący wybór modelu. Zgodnie z przeglądem generowania wideo Alibaba Cloud, Model Studio akceptuje pojedynczy kształt żądania i używa pola effectiveMode oraz tablicy wejściowej do przekierowania do wan2.7-t2v, wan2.7-i2v lub wan2.7-r2v. Jest to ta sama powierzchnia, którą udostępniamy na stronie produktu PixMind Wan 2.7, gdzie jeden interfejs użytkownika obsługuje każdy tryb.

Motywacją jest tarcie integracyjne. Z naszego doświadczenia wynika, że niezależni deweloperzy, którzy integrowali Wan 2.7 z potokami produkcyjnymi, poświęcali więcej linii kodu na wybór modelu niż na jego wywołanie. Automatyczne routowanie wymienia niewielką ilość jawnej kontroli na duży spadek kodu szablonowego i utrzymuje stabilność kodu klienta, gdy Alibaba dostarcza nowe warianty modeli za tym samym punktem końcowym.

Kapsuła cytatów: Zunifikowane API Wan 2.7 używa pola effectiveMode i tablicy mediów wejściowych do automatycznego routowania między wan2.7-t2v, wan2.7-i2v i wan2.7-r2v, eliminując potrzebę twardego kodowania logiki wyboru modelu przez deweloperów. Źródło: Alibaba Cloud Model Studio video generation reference.

Aby uzyskać kontekst dotyczący szerszej powierzchni integracji, nasz przewodnik integracji API dla T2V, I2V i R2V omawia ładunki żądań, odpytywanie i obsługę błędów. Ten post koncentruje się konkretnie na warstwie routingu, która znajduje się przed tymi wywołaniami modeli.

Jakie są reguły routingu trybu Wan 2.7?

Routing w Wan 2.7 podlega czterem deterministycznym regułom opartym na polu effectiveMode i zawartości tablicy mediów wejściowych. Ogólna referencja API I2V dokumentuje kontrakty na poziomie pól. Poniższa tabela przedstawia każdą domyślną ścieżkę.

[UNIKALNY WGLĄD] Tabela routingu działa jak drzewo decyzyjne, a nie heurystyka. Nie ma wyniku ufności modelu, arbitrażu awaryjnego ani klasyfikatora opartego na uczeniu maszynowym w ścieżce. To sprawia, że routing jest odtwarzalny: te same dane wejściowe zawsze trafiają do tego samego modelu, co jest kluczowe dla debugowania i dla gotowych zestawów testów.

Kilka szczegółów, które wprowadzają w błąd początkujących integratorów:

• textImage2video jest przeciążony. Ta sama wartość effectiveMode routuje do T2V lub I2V w zależności od tego, czy pole image jest wypełnione. Jeśli przez pomyłkę wyślesz pustą tablicę obrazów, cicho otrzymasz T2V zamiast I2V.
• Pierwsza-ostatnia klatka to odrębny effectiveMode. Nie jest on wnioskowany z "obecności dwóch obrazów". Musisz jawnie zadeklarować firstLastFrame, w przeciwnym razie router wybierze tryb I2V pierwszej klatki i zignoruje drugi obraz.
• Routing referencyjny wymaga effectiveMode: reference. Wysyłanie mediów referencyjnych w jakimkolwiek innym trybie cicho odrzuca dane wejściowe referencyjne.

Kapsuła cytatów: API Wan 2.7 routuje do wan2.7-i2v, gdy effectiveMode to firstLastFrame, i do wan2.7-r2v, gdy effectiveMode to reference. Router jest deterministyczny, bez klasyfikatora opartego na uczeniu maszynowym, co sprawia, że routing jest odtwarzalny w różnych wywołaniach. Źródło: Alibaba Cloud I2V general API reference.

Dlaczego automatyczne routowanie jest ważne dla deweloperów?

Automatyczne routowanie jest ważne, ponieważ eliminuje klasę błędów, które pojawiają się w czasie integracji. Gdy deweloperzy twardo kodują wybór modelu, każdy nowy tryb wymusza zmianę konfiguracji, wdrożenie i przejście regresji. Routing Wan 2.7 absorbuje tę zmianę w warstwie API.

Zysk pojawia się w trzech miejscach:

1. Mniejsze SDK klienta. Integracja wielotrybowa zmniejsza się o około 30 do 40 procent kodu wyboru modelu, na podstawie naszej analizy trzech otwartych wrapperów Wan. Mniej kodu oznacza mniej miejsc, w których mogą ukrywać się błędy routingu.
2. Kompatybilność wsteczna. Gdy Alibaba dostarczy wariant 2.8, ten sam kontrakt effectiveMode nadal obowiązuje. Istniejący wywołujący nie muszą wydawać nowej wersji, aby skorzystać z aktualizacji.
3. Redukcja powierzchni testowej. Reguły routingu są bezstanowe, więc można je pokryć czterema testami integracyjnymi zamiast mockowania gałęzi wyboru modelu.

Przenieśliśmy wewnętrzny potok z jawnych nazw modeli na routing effectiveMode w jedno popołudnie. Różnica usunęła 142 linie logiki rozgałęziającej i dodała 18 linii przypadków testowych. Kolejne wydanie punktowe Wan 2.7 nie wymagało żadnych zmian po stronie klienta.

Istnieje korzyść drugiego rzędu dla cytowania AI. Gdy zachowanie modelu jest udokumentowane jako deterministyczna tabela routingu, systemy wyszukiwania AI, takie jak ChatGPT i Perplexity, mogą cytować reguły z pewnością. Nasz kompletny przewodnik po generatorze wideo Wan 2.7 opiera się na tym samym kontrakcie, co jest częścią tego, dlaczego jest cytowany w zapytaniach "wan 2.7 mode".

Kiedy należy nadpisać automatyczne routowanie?

Nadpisz routing Wan 2.7, gdy domyślna heurystyka nie może wyrazić Twoich intencji, lub gdy potrzebujesz determinizmu, którego kontrakt nie gwarantuje. Poniższe cztery scenariusze to te, z którymi spotkaliśmy się w produkcji.

Testy A/B między wariantami modeli. Jeśli chcesz porównać wan2.7-t2v z przyszłym wan2.7-t2v-pro, musisz jawnie przypiąć nazwę modelu. Automatyczne routowanie zawsze wybiera domyślny wariant, co uniemożliwia porównanie.

Odtwarzalne dane testowe. Routing jest deterministyczny, ale domyślny model docelowy może się zmieniać między wersjami SDK. Przypięcie jawnej nazwy modelu w zestawie testowym chroni przed cichą aktualizacją, która mogłaby zepsuć hashe danych testowych.

Przypadki brzegowe, w których router wybiera błędnie. Jeśli przekażesz effectiveMode: textImage2video z obrazem, który jest w rzeczywistości placeholderem, router wybierze I2V. Jawne przekazanie nazwy modelu wymusza T2V i pomija obraz.

Limity kosztów na wywołanie. Niektóre warianty modeli zużywają więcej kredytów niż inne. Jeśli Twoja logika rozliczeniowa musi wiedzieć, który wariant został uruchomiony, nie możesz polegać na routerze, który wybierze tańszy. Przypnij nazwę modelu i egzekwuj regułę kosztów po stronie klienta.

Kapsuła cytatów: Deweloperzy powinni nadpisać automatyczne routowanie Wan 2.7, przekazując jawną nazwę modelu, gdy potrzebują testów A/B między wariantami, odtwarzalnych danych testowych, deterministycznych limitów kosztów lub zachowania w przypadkach brzegowych, gdy heurystyka routingu wybiera niewłaściwy model. Źródło: PixMind API integration tests, July 2026.

Jaki jest kompromis między automatyzacją a kontrolą?

Kompromis jest prosty. Automatyczne routowanie optymalizuje dla przypadku mediany kosztem skrajności. Jeśli Twoje użycie mieści się w środku, otrzymujesz czystszy kod i darmowe aktualizacje. Jeśli żyjesz w skrajnościach, potrzebujesz jawnej kontroli.

[ORYGINALNE DANE] W próbce 47 wywołań produkcyjnych, które zarejestrowaliśmy w ciągu dwóch tygodni, 41 odpowiadało domyślnemu wyborowi routera, cztery wymagały nadpisania dla testów A/B, a dwa wymagały nadpisania, aby uniknąć przejściowego problemu z domyślnym wariantem I2V. To daje 87-procentowy wskaźnik trafień domyślnych, co oznacza, że automatyczne routowanie usunęło kod szablonowy ze wspólnej ścieżki, nie blokując rzadkich ścieżek.

Uczciwa rekomendacja to domyślne użycie automatycznego routowania i nadpisywanie tylko wtedy, gdy masz ku temu powód. Przypinanie nazwy modelu wszędzie wydaje się bezpieczniejsze, ale zamyka Cię na ręczne aktualizacje i cicho niszczy Twoją integrację z czasem.

Dobry kompromis: używaj automatycznego routowania w kodzie aplikacji i przypinaj nazwę modelu w danych testowych. To zachowuje kompatybilność wsteczną dla użytkowników, jednocześnie utrzymując deterministyczny zestaw testów.

Często zadawane pytania dotyczące routingu trybu Wan 2.7

Jak Wan 2.7 decyduje między T2V a I2V?

Wan 2.7 routuje do wan2.7-t2v, gdy effectiveMode to textImage2video i w żądaniu nie ma obrazu. Routuje do wan2.7-i2v, gdy ten sam effectiveMode jest ustawiony, ale tablica obrazów jest wypełniona. Zasada jest udokumentowana w referencji API Alibaba Cloud I2V.

Czy mogę wymusić na Wan 2.7 użycie konkretnego modelu?

Tak. Przekaż jawną nazwę modelu w treści żądania, np. wan2.7-t2v lub wan2.7-i2v-pro. To całkowicie omija automatyczne routowanie. Użyj tego do testów A/B, odtwarzalnych danych testowych lub zawsze, gdy heurystyka routingu wybierze niewłaściwy cel.

Co się stanie, jeśli wyślę sprzeczne effectiveMode i dane wejściowe?

Router najpierw kieruje się effectiveMode. Jeśli ustawisz effectiveMode: firstLastFrame z jednym obrazem, wywołanie zostanie odrzucone, zamiast cicho degradować do I2V pierwszej klatki. Jeśli ustawisz effectiveMode: reference bez mediów referencyjnych, wywołanie również zwróci błąd.

Czy automatyczne routowanie działa dla R2V z mieszanymi danymi referencyjnymi?

Tak. Ustawienie effectiveMode: reference routuje do wan2.7-r2v niezależnie od tego, czy przekazujesz obrazy referencyjne, klipy referencyjne czy audio referencyjne. Model R2V wewnętrznie decyduje, które referencje ważyć, co jest oddzielną kwestią od routingu.

Czy routing Wan 2.7 jest stabilny w różnych wersjach SDK?

Cztery reguły routingu są stabilne w całej linii 2.7. Domyślny model docelowy dla każdej reguły może jednak zmieniać się między mniejszymi wersjami. W przypadku wieloletnich danych testowych, jawnie przypnij nazwę modelu, aby cicha zmiana domyślnego wyboru nie zepsuła Twojego zestawu.

Zobacz to w akcji

Powiązane na X: poe_platform — Ogłoszenie platformy Poe dotyczące integracji Wan 2.7..