Wan 2.7 模式自動路由如何運作
主要重點
- Wan 2.7 提供一個統一的 API 端點，根據
effectiveMode欄位和您傳送的輸入，在wan2.7-t2v、wan2.7-i2v和wan2.7-r2v之間進行路由。 - 四個路由規則涵蓋所有預設路徑：純文字輸入導向 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 產品頁面 上公開的介面相同，該頁面使用一個 UI 驅動所有模式。
動機是為了減少整合摩擦。根據我們的經驗，獨立開發人員將 Wan 2.7 整合到生產管線時，花費在選擇模型上的程式碼行數比呼叫模型本身還要多。自動路由以犧牲少量明確控制為代價，大幅減少了樣板程式碼，並在 Alibaba 透過相同端點發布新模型變體時，保持客戶端程式碼的穩定性。
引用摘要：Wan 2.7 的統一 API 使用
effectiveMode欄位和輸入媒體陣列在wan2.7-t2v、wan2.7-i2v和wan2.7-r2v之間自動路由，消除了開發人員硬編碼模型選擇邏輯的需求。來源：Alibaba Cloud Model Studio 影片生成參考。
關於更廣泛的整合介面，我們的 T2V、I2V 和 R2V API 整合指南 介紹了請求負載、輪詢和錯誤處理。本文則專注於這些模型呼叫之前的路由層。
Wan 2.7 模式路由規則有哪些？
Wan 2.7 中的路由遵循四個確定性規則，這些規則基於 effectiveMode 欄位和輸入媒體陣列的內容。I2V 一般 API 參考 文件記錄了欄位級別的契約。下表列出了所有預設路徑。
effectiveMode 值 |
輸入媒體是否存在 | 路由模型 | 結果模式 |
|---|---|---|---|
textImage2video |
None (text prompt only) | wan2.7-t2v |
文字轉影片 |
textImage2video |
One or more images | wan2.7-i2v |
圖片轉影片 |
firstLastFrame |
Two images (first + last) | wan2.7-i2v |
首尾幀插值 |
reference |
Reference images, clips, or audio | wan2.7-r2v |
參考轉影片 |
[獨特見解] 路由表是一個決策樹，而非啟發式演算法。路徑中沒有模型置信度分數、沒有回退仲裁，也沒有機器學習分類器。這使得路由可重現：相同的輸入總是導向相同的模型，這對於偵錯和預設測試套件至關重要。
一些初次整合者容易遇到的細節：
textImage2video被過載使用。 相同的effectiveMode值根據image欄位是否被填入，會路由到 T2V 或 I2V。如果您不小心傳送了一個空的圖片陣列，您會默默地得到 T2V 而不是 I2V。- 首尾幀是一個獨立的
effectiveMode。 它不是從「存在兩張圖片」推斷出來的。您必須明確宣告firstLastFrame，否則路由器會選擇 I2V 首幀模式並忽略第二張圖片。 - 參考路由需要
effectiveMode: reference。 在任何其他模式下傳送參考媒體會默默地丟棄參考輸入。
引用摘要：當
effectiveMode為firstLastFrame時，Wan 2.7 API 會路由到wan2.7-i2v；當effectiveMode為reference時，則路由到wan2.7-r2v。該路由器是確定性的，沒有學習型分類器，這使得路由在不同呼叫之間可重現。來源：Alibaba Cloud I2V 一般 API 參考。
自動路由對開發人員為何重要？
自動路由之所以重要，是因為它消除了整合時出現的一類錯誤。當開發人員硬編碼模型選擇時，每個新模式都會強制進行配置更改、部署和回歸測試。Wan 2.7 的路由在 API 層內部吸收了這種變化。
優勢體現在三個方面：
- 更小的客戶端 SDK。 根據我們對三個開源 Wan 包裝器的審查，多模式整合的模型選擇程式碼大約減少了 30% 到 40%。程式碼越少，路由錯誤隱藏的地方就越少。
- 向前相容性。 當 Alibaba 發布 2.8 變體時，相同的
effectiveMode契約仍然適用。現有呼叫者無需發布新版本即可獲得升級。 - 測試範圍縮減。 路由規則是無狀態的，因此您可以用四個整合測試來涵蓋它們，而不是模擬模型選擇分支。
我們在一個下午將內部管線從明確的模型名稱移植到 effectiveMode 路由。差異移除了 142 行分支邏輯，並增加了 18 行測試案例。隨後的 Wan 2.7 小版本發布無需客戶端進行任何更改。
對於 AI 引用還有一個次要好處。當模型行為被記錄為確定性路由表時，像 ChatGPT 和 Perplexity 這樣的 AI 搜尋系統可以自信地引用這些規則。我們的 Wan 2.7 影片生成器完整指南 依賴相同的契約，這也是它在「wan 2.7 mode」查詢中被引用的部分原因。
何時應手動覆寫自動路由？
當預設的啟發式演算法無法表達您的意圖，或者當您需要契約不保證的確定性時，就應覆寫 Wan 2.7 的路由。以下四種情境是我們在生產環境中遇到的。
跨模型變體的 A/B 測試。 如果您想比較 wan2.7-t2v 和未來的 wan2.7-t2v-pro，您需要明確指定模型名稱。自動路由總是選擇預設變體，這會使比較失效。
可重現的測試夾具。 路由是確定性的，但預設目標模型可能會在 SDK 版本之間發生變化。在您的測試套件中明確指定模型名稱，可以防止靜默升級破壞夾具雜湊。
路由器選擇錯誤的邊緣情況。 如果您傳遞 effectiveMode: textImage2video 並帶有一個實際上是佔位符的圖片，路由器會選擇 I2V。明確傳遞模型名稱會強制使用 T2V 並跳過該圖片。
每次呼叫的成本上限。 某些模型變體比其他模型消耗更多的點數。如果您的計費邏輯需要知道運行了哪個變體，您不能依賴路由器選擇便宜的那個。請指定模型名稱並在客戶端強制執行成本規則。
引用摘要：當開發人員需要跨變體進行 A/B 測試、可重現的測試夾具、確定性成本上限，或在路由啟發式演算法選擇錯誤模型的邊緣情況下，應透過傳遞明確的模型名稱來覆寫 Wan 2.7 自動路由。來源：PixMind API 整合測試，2026 年 7 月。
自動化與控制之間的權衡是什麼？
權衡很簡單。自動路由以犧牲極端情況為代價，優化了中位數情況。如果您的使用情況處於中間，您將獲得更簡潔的程式碼和免費升級。如果您處於極端情況，則需要明確控制。
| 維度 | 自動路由 | 明確模型名稱 |
|---|---|---|
| 整合程式碼大小 | 更小 | 更大 |
| 向前相容性 | 自動 | 需要手動升級 |
| 可偵錯性 | 隱式（檢查路由模型） | 明確（呼叫者知道） |
| A/B 測試 | 不可能 | 可能 |
| 成本可預測性 | 取決於預設變體 | 呼叫者控制 |
| 測試確定性 | 在版本內確定 | 跨版本確定 |
[原始數據] 在我們兩週內記錄的 47 個生產呼叫樣本中，有 41 個符合路由器的預設選擇，四個需要覆寫以進行 A/B 測試，兩個需要覆寫以避免預設 I2V 變體的暫時性問題。這是一個 87% 的預設命中率，這意味著自動路由從常用路徑中移除了樣板程式碼，同時沒有阻礙罕見路徑。
誠實的建議是預設使用自動路由，只有在有理由時才進行覆寫。在所有地方都指定模型名稱感覺更安全，但這會讓您陷入手動升級的困境，並隨著時間的推移悄悄地侵蝕您的整合。
一個好的折衷方案：在應用程式程式碼中使用自動路由，並在測試夾具中指定模型名稱。這既為用戶保留了向前相容性，又保持了測試套件的確定性。
!(https://cdn.pixmind.io/posts/wan-2-7-mode-auto-routing/tradeoff-chart.png)
Wan 2.7 模式路由常見問題
Wan 2.7 如何在 T2V 和 I2V 之間做出選擇？
當 effectiveMode 為 textImage2video 且請求中沒有圖片時，Wan 2.7 會路由到 wan2.7-t2v。當設定相同的 effectiveMode 但圖片陣列被填入時，它會路由到 wan2.7-i2v。此規則記錄在 Alibaba Cloud I2V API 參考 中。
我能否強制 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 的公告..
