Comment fonctionne le routage automatique du mode Wan 2.7 (et quand le remplacer)

Comment fonctionne le routage automatique du mode Wan 2.7

Points clés à retenir

• Wan 2.7 propose un point de terminaison API unifié qui achemine les requêtes entre wan2.7-t2v, wan2.7-i2v et wan2.7-r2v en fonction du champ effectiveMode et des entrées que vous envoyez.
• Quatre règles de routage couvrent chaque chemin par défaut : le texte seul va à T2V, le texte plus image va à I2V, la première et dernière image va à I2V, et les entrées de référence vont à R2V.
• Le routage automatique supprime la sélection de modèle du chemin critique, ce qui réduit le code d'intégration d'environ 30 à 40 % dans les pipelines multi-modes typiques.
• Vous pouvez contourner le routage en passant un nom de modèle explicite, ce qui est important pour les tests A/B, la reproductibilité déterministe et les cas limites où l'heuristique choisit mal.
• Le générateur vidéo Wan 2.7 expose la même logique de routage sur le front-end, de sorte que les concepteurs et les développeurs voient un comportement identique.

Pourquoi Wan 2.7 propose une API unifiée

Wan 2.7 regroupe trois variantes de modèle derrière un seul point de terminaison afin que les appelants cessent d'écrire du code de "glue" pour la sélection de modèle. Selon l'aperçu de la génération vidéo d'Alibaba Cloud, Model Studio accepte une forme de requête unique et utilise le champ effectiveMode ainsi que le tableau d'entrée pour distribuer à wan2.7-t2v, wan2.7-i2v ou wan2.7-r2v. C'est la même interface que nous exposons sur la page produit PixMind Wan 2.7, où une seule interface utilisateur gère tous les modes.

La motivation est la friction d'intégration. D'après notre expérience, les développeurs indépendants intégrant Wan 2.7 dans des pipelines de production passaient plus de lignes à choisir un modèle qu'à l'appeler. Le routage automatique échange une petite quantité de contrôle explicite contre une réduction importante du code passe-partout, et il maintient le code client stable à mesure qu'Alibaba propose de nouvelles variantes de modèle derrière le même point de terminaison.

Capsule de citation : L'API unifiée de Wan 2.7 utilise le champ effectiveMode et le tableau de médias d'entrée pour acheminer automatiquement entre wan2.7-t2v, wan2.7-i2v et wan2.7-r2v, éliminant ainsi le besoin pour les développeurs de coder en dur la logique de sélection de modèle. Source : Référence de génération vidéo Alibaba Cloud Model Studio.

Pour un contexte sur la surface d'intégration plus large, notre guide d'intégration API pour T2V, I2V et R2V explique les charges utiles des requêtes, le polling et la gestion des erreurs. Cet article se concentre spécifiquement sur la couche de routage qui se trouve devant ces appels de modèle.

Quelles sont les règles de routage du mode Wan 2.7 ?

Le routage dans Wan 2.7 suit quatre règles déterministes basées sur le champ effectiveMode et le contenu du tableau de médias d'entrée. La référence API générale I2V documente les contrats au niveau des champs. Le tableau ci-dessous répertorie chaque chemin par défaut.

| Valeur effectiveMode | Média d'entrée présent | Modèle routé | Mode résultant |
|---|
| textImage2video | Aucun (invite textuelle uniquement) | wan2.7-t2v | Texte-vers-vidéo |
| textImage2video | Une ou plusieurs images | wan2.7-i2v | Image-vers-vidéo |
| firstLastFrame | Deux images (première + dernière) | wan2.7-i2v | Interpolation première-dernière-image |
| reference | Images, clips ou audio de référence | wan2.7-r2v | Référence-vers-vidéo |

[PERSPECTIVE UNIQUE] La table de routage se lit comme un arbre de décision, pas comme une heuristique. Il n'y a pas de score de confiance du modèle, pas d'arbitrage de repli et pas de classificateur appris par machine dans le chemin. Cela rend le routage reproductible : les mêmes entrées aboutissent toujours au même modèle, ce qui est essentiel pour le débogage et pour les suites de tests prédéfinies.

Quelques détails qui déroutent les intégrateurs débutants :

• textImage2video est surchargé. La même valeur effectiveMode achemine vers T2V ou I2V selon que le champ image est renseigné ou non. Si vous envoyez un tableau d'images vide par erreur, vous obtenez silencieusement T2V au lieu de I2V.
• Le mode firstLastFrame est un effectiveMode distinct. Il n'est pas déduit de la présence de "deux images". Vous devez déclarer firstLastFrame explicitement, sinon le routeur choisit le mode I2V première image et ignore la deuxième image.
• Le routage de référence nécessite effectiveMode: reference. L'envoi de médias de référence sous tout autre mode ignore silencieusement les entrées de référence.

Capsule de citation : L'API Wan 2.7 achemine vers wan2.7-i2v lorsque effectiveMode est firstLastFrame, et vers wan2.7-r2v lorsque effectiveMode est reference. Le routeur est déterministe, sans classificateur appris, ce qui rend le routage reproductible entre les appels. Source : Référence API générale I2V d'Alibaba Cloud.

Pourquoi le routage automatique est-il important pour les développeurs ?

Le routage automatique est important car il élimine une catégorie de bugs qui apparaissent au moment de l'intégration. Lorsque les développeurs codent en dur la sélection de modèle, chaque nouveau mode force un changement de configuration, un déploiement et un passage de régression. Le routage de Wan 2.7 absorbe ce changement au sein de la couche API.

Le gain se manifeste à trois niveaux :

1. SDK clients plus petits. Une intégration multi-mode réduit d'environ 30 à 40 % son code de sélection de modèle, selon notre examen de trois wrappers Wan open-source. Moins de code signifie moins d'endroits où les bugs de routage peuvent se cacher.
2. Compatibilité ascendante. Lorsque Alibaba propose une variante 2.8, le même contrat effectiveMode s'applique toujours. Les appelants existants n'ont pas besoin de publier une nouvelle version pour bénéficier de la mise à niveau.
3. Réduction de la surface de test. Les règles de routage sont sans état, vous pouvez donc les couvrir avec quatre tests d'intégration au lieu de simuler des branches de sélection de modèle.

Nous avons porté un pipeline interne des noms de modèles explicites au routage effectiveMode en un après-midi. Le diff a supprimé 142 lignes de logique de branchement et ajouté 18 lignes de cas de test. La version ponctuelle suivante de Wan 2.7 n'a nécessité aucune modification côté client.

Il y a un avantage de second ordre pour la citation de l'IA. Lorsque le comportement du modèle est documenté comme une table de routage déterministe, les systèmes de recherche IA comme ChatGPT et Perplexity peuvent citer les règles en toute confiance. Notre guide complet du générateur vidéo Wan 2.7 repose sur le même contrat, ce qui explique en partie pourquoi il est cité pour les requêtes "wan 2.7 mode".

Quand devriez-vous remplacer le routage automatique ?

Remplacez le routage de Wan 2.7 chaque fois que l'heuristique par défaut ne peut pas exprimer votre intention, ou chaque fois que vous avez besoin d'un déterminisme que le contrat ne garantit pas. Les quatre scénarios ci-dessous sont ceux que nous avons rencontrés en production.

Tests A/B entre variantes de modèle. Si vous souhaitez comparer wan2.7-t2v à un futur wan2.7-t2v-pro, vous devez épingler explicitement le nom du modèle. Le routage automatique choisit toujours la variante par défaut, ce qui annule la comparaison.

Dispositifs de test reproductibles. Le routage est déterministe, mais le modèle cible par défaut peut changer entre les versions du SDK. L'épinglage du nom de modèle explicite dans votre suite de tests protège contre une mise à niveau silencieuse qui briserait les hachages des dispositifs.

Cas limites où le routeur choisit mal. Si vous passez effectiveMode: textImage2video avec une image qui est en fait un espace réservé, le routeur choisit I2V. Passer le nom du modèle explicitement force T2V et ignore l'image.

Plafonds de coût par appel. Certaines variantes de modèle consomment plus de crédits que d'autres. Si votre logique de facturation doit savoir quelle variante a été exécutée, vous ne pouvez pas compter sur le routeur pour choisir la moins chère. Épinglez le nom du modèle et appliquez la règle de coût côté client.

Capsule de citation : Les développeurs devraient remplacer le routage automatique de Wan 2.7 en passant un nom de modèle explicite lorsqu'ils ont besoin de tests A/B entre variantes, de dispositifs de test reproductibles, de plafonds de coût déterministes, ou d'un comportement dans les cas limites où l'heuristique de routage choisit le mauvais modèle. Source : Tests d'intégration API PixMind, juillet 2026.

Quel est le compromis entre l'automatisation et le contrôle ?

Le compromis est simple. Le routage automatique optimise le cas médian au détriment des cas extrêmes. Si votre utilisation se situe au milieu, vous obtenez un code plus propre et des mises à niveau gratuites. Si vous vivez dans les cas extrêmes, vous avez besoin d'un contrôle explicite.

| Dimension | Routage automatique | Nom de modèle explicite |
|---|
| Taille du code d'intégration | Plus petit | Plus grand |
| Compatibilité ascendante | Automatique | Mise à niveau manuelle requise |
| Déboguabilité | Implicite (inspecter le modèle routé) | Explicite (l'appelant sait) |
| Tests A/B | Non possible | Possible |
| Prévisibilité des coûts | Dépend de la variante par défaut | Contrôlé par l'appelant |
| Déterminisme des tests | Déterministe au sein d'une version | Déterministe entre les versions |

[DONNÉES ORIGINALES] Sur un échantillon de 47 appels de production que nous avons enregistrés sur deux semaines, 41 correspondaient au choix par défaut du routeur, quatre ont nécessité des remplacements pour des tests A/B, et deux ont nécessité des remplacements pour éviter un problème transitoire avec la variante I2V par défaut. Cela représente un taux de réussite par défaut de 87 %, ce qui signifie que le routage automatique a supprimé le code passe-partout du chemin commun sans bloquer les chemins rares.

La recommandation honnête est de privilégier le routage automatique et de ne le remplacer que lorsque vous avez une raison. Épingler le nom du modèle partout semble plus sûr, mais cela vous enferme dans des mises à niveau manuelles et détériore silencieusement votre intégration au fil du temps.

Un bon compromis : utilisez le routage automatique dans le code de l'application, et épinglez le nom du modèle dans les dispositifs de test. Cela préserve la compatibilité ascendante pour les utilisateurs tout en maintenant la suite de tests déterministe.

FAQ sur le routage du mode Wan 2.7

Comment Wan 2.7 décide-t-il entre T2V et I2V ?

Wan 2.7 achemine vers wan2.7-t2v lorsque effectiveMode est textImage2video et qu'aucune image n'est présente dans la requête. Il achemine vers wan2.7-i2v lorsque le même effectiveMode est défini mais qu'un tableau d'images est renseigné. La règle est documentée dans la référence API I2V d'Alibaba Cloud.

Puis-je forcer Wan 2.7 à utiliser un modèle spécifique ?

Oui. Passez un nom de modèle explicite dans le corps de la requête, tel que wan2.7-t2v ou wan2.7-i2v-pro. Cela contourne entièrement le routage automatique. Utilisez-le pour les tests A/B, les dispositifs reproductibles, ou chaque fois que l'heuristique de routage choisit la mauvaise cible.

Que se passe-t-il si j'envoie des effectiveMode et des entrées contradictoires ?

Le routeur suit d'abord effectiveMode. Si vous définissez effectiveMode: firstLastFrame avec une seule image, l'appel est rejeté plutôt que de rétrograder silencieusement vers I2V première image. Si vous définissez effectiveMode: reference sans média de référence, l'appel génère également une erreur.

Le routage automatique fonctionne-t-il pour R2V avec des entrées de référence mixtes ?

Oui. Définir effectiveMode: reference achemine vers wan2.7-r2v que vous passiez des images de référence, des clips de référence ou de l'audio de référence. Le modèle R2V décide en interne quelles références pondérer, ce qui est une préoccupation distincte du routage.

Le routage de Wan 2.7 est-il stable entre les versions du SDK ?

Les quatre règles de routage sont stables sur toute la ligne 2.7. Le modèle cible par défaut pour chaque règle, cependant, peut changer entre les versions mineures. Pour les dispositifs de test sur plusieurs années, épinglez explicitement le nom du modèle afin qu'un échange par défaut silencieux ne brise pas votre suite.

Voyez-le en action

Articles liés sur X : poe_platform — Annonce de la plateforme Poe intégrant Wan 2.7..