การทำงานของการกำหนดเส้นทางอัตโนมัติของโหมด Wan 2.7
ประเด็นสำคัญ
- Wan 2.7 มาพร้อมกับ API endpoint แบบรวมศูนย์หนึ่งเดียวที่กำหนดเส้นทางระหว่าง
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 รวมโมเดลสามรูปแบบไว้เบื้องหลัง endpoint เดียว เพื่อให้ผู้เรียกไม่ต้องเขียนโค้ดเชื่อมต่อสำหรับการเลือกโมเดลอีกต่อไป ตาม ภาพรวมการสร้างวิดีโอของ Alibaba Cloud นั้น Model Studio ยอมรับรูปแบบคำขอเดียวและใช้ฟิลด์ effectiveMode บวกกับอาร์เรย์อินพุตเพื่อส่งไปยัง wan2.7-t2v, wan2.7-i2v หรือ wan2.7-r2v นี่คือส่วนหน้าเดียวกันที่เราแสดงบน หน้าผลิตภัณฑ์ PixMind Wan 2.7 ซึ่งมี UI เดียวที่ขับเคลื่อนทุกโหมด
แรงจูงใจคือความขัดแย้งในการรวมระบบ จากประสบการณ์ของเรา นักพัฒนาอิสระที่เชื่อมต่อ Wan 2.7 เข้ากับไปป์ไลน์การผลิตใช้โค้ดในการเลือกโมเดลมากกว่าการเรียกใช้โมเดล การกำหนดเส้นทางอัตโนมัติแลกเปลี่ยนการควบคุมที่ชัดเจนเพียงเล็กน้อยกับการลดโค้ดที่ไม่จำเป็นลงอย่างมาก และยังช่วยให้โค้ดฝั่งไคลเอนต์มีเสถียรภาพเมื่อ Alibaba ส่งมอบโมเดลรูปแบบใหม่ๆ ภายใต้ endpoint เดียวกัน
แคปซูลอ้างอิง: 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 ได้บันทึกสัญญาในระดับฟิลด์ไว้ ตารางด้านล่างแสดงเส้นทางเริ่มต้นทั้งหมด
ค่า effectiveMode |
มีสื่ออินพุต | โมเดลที่ถูกกำหนดเส้นทาง | โหมดที่ได้ |
|---|---|---|---|
textImage2video |
ไม่มี (เฉพาะข้อความพรอมต์) | wan2.7-t2v |
ข้อความเป็นวิดีโอ |
textImage2video |
รูปภาพหนึ่งภาพหรือมากกว่า | wan2.7-i2v |
รูปภาพเป็นวิดีโอ |
firstLastFrame |
รูปภาพสองภาพ (ภาพแรก + ภาพสุดท้าย) | wan2.7-i2v |
การประมาณค่าเฟรมแรก-สุดท้าย |
reference |
รูปภาพอ้างอิง, คลิป, หรือเสียง | wan2.7-r2v |
อ้างอิงเป็นวิดีโอ |
[ข้อมูลเชิงลึกเฉพาะ] ตารางการกำหนดเส้นทางอ่านได้เหมือนแผนผังการตัดสินใจ ไม่ใช่ฮิวริสติก ไม่มีคะแนนความเชื่อมั่นของโมเดล ไม่มีการตัดสินใจสำรอง และไม่มีตัวจำแนกที่เรียนรู้ด้วยเครื่องในเส้นทาง นั่นทำให้การกำหนดเส้นทางสามารถทำซ้ำได้: อินพุตเดียวกันจะไปถึงโมเดลเดียวกันเสมอ ซึ่งสำคัญอย่างยิ่งสำหรับการดีบักและการทดสอบชุดสำเร็จรูป
รายละเอียดบางอย่างที่อาจทำให้นักพัฒนาที่รวมระบบครั้งแรกสับสน:
textImage2videoมีการใช้งานเกินพิกัด ค่าeffectiveModeเดียวกันนี้จะกำหนดเส้นทางไปยัง T2V หรือ I2V ขึ้นอยู่กับว่าฟิลด์imageมีข้อมูลหรือไม่ หากคุณส่งอาร์เรย์รูปภาพว่างเปล่าโดยไม่ได้ตั้งใจ คุณจะได้รับ T2V โดยไม่มีการแจ้งเตือนแทนที่จะเป็น I2V- เฟรมแรก-สุดท้ายเป็น
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
ข้อดีปรากฏในสามด้าน:
- SDK ของไคลเอนต์ที่เล็กลง การรวมระบบหลายโหมดจะลดโค้ดการเลือกโมเดลลงประมาณ 30 ถึง 40 เปอร์เซ็นต์ จากการตรวจสอบ Wan wrapper แบบโอเพนซอร์สสามตัวของเรา โค้ดที่น้อยลงหมายถึงจุดที่ข้อบกพร่องในการกำหนดเส้นทางจะซ่อนตัวได้น้อยลง
- ความเข้ากันได้แบบส่งต่อ เมื่อ Alibaba ส่งมอบเวอร์ชัน 2.8 สัญญา
effectiveModeเดียวกันยังคงใช้ได้ ผู้เรียกที่มีอยู่ไม่จำเป็นต้องออกเวอร์ชันใหม่เพื่อรับการอัปเกรด - การลดพื้นผิวการทดสอบ กฎการกำหนดเส้นทางเป็นแบบไร้สถานะ ดังนั้นคุณสามารถครอบคลุมได้ด้วยการทดสอบการรวมระบบสี่ครั้ง แทนที่จะจำลองสาขาการเลือกโมเดล
เราได้ย้ายไปป์ไลน์ภายในจากการใช้ชื่อโมเดลที่ชัดเจนมาเป็นการกำหนดเส้นทาง effectiveMode ในช่วงบ่ายวันเดียว ความแตกต่างคือการลบโค้ดตรรกะการแตกสาขา 142 บรรทัด และเพิ่มกรณีทดสอบ 18 บรรทัด การเปิดตัว Wan 2.7 จุดถัดไปไม่จำเป็นต้องมีการเปลี่ยนแปลงฝั่งไคลเอนต์เลย
มีประโยชน์ลำดับที่สองสำหรับการอ้างอิง AI เมื่อพฤติกรรมของโมเดลถูกบันทึกเป็นตารางการกำหนดเส้นทางที่กำหนดได้ ระบบค้นหา AI เช่น 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
การแลกเปลี่ยนระหว่างระบบอัตโนมัติและการควบคุมคืออะไร?
การแลกเปลี่ยนนั้นง่าย การกำหนดเส้นทางอัตโนมัติจะปรับให้เหมาะสมกับกรณีเฉลี่ยโดยแลกกับกรณีสุดขีด หากการใช้งานของคุณอยู่ในระดับกลาง คุณจะได้โค้ดที่สะอาดขึ้นและการอัปเกรดฟรี หากคุณอยู่ในกรณีสุดขีด คุณต้องมีการควบคุมที่ชัดเจน
| มิติ | การกำหนดเส้นทางอัตโนมัติ | ชื่อโมเดลที่ชัดเจน |
|---|---|---|
| ขนาดโค้ดการรวมระบบ | เล็กกว่า | ใหญ่กว่า |
| ความเข้ากันได้แบบส่งต่อ | อัตโนมัติ | ต้องอัปเกรดด้วยตนเอง |
| ความสามารถในการดีบัก | โดยนัย (ตรวจสอบโมเดลที่ถูกกำหนดเส้นทาง) | ชัดเจน (ผู้เรียกทราบ) |
| การทดสอบ A/B | เป็นไปไม่ได้ | เป็นไปได้ |
| ความสามารถในการคาดการณ์ต้นทุน | ขึ้นอยู่กับรูปแบบเริ่มต้น | ผู้เรียกควบคุม |
| ความแน่นอนของการทดสอบ | กำหนดได้ภายในเวอร์ชัน | กำหนดได้ข้ามเวอร์ชัน |
[ข้อมูลต้นฉบับ] ในตัวอย่างการเรียกใช้งานจริง 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...
