Wan 2.7 모드 자동 라우팅 작동 방식
주요 내용
- Wan 2.7은
effectiveMode필드와 전송하는 입력에 따라wan2.7-t2v,wan2.7-i2v,wan2.7-r2v사이를 라우팅하는 하나의 통합 API 엔드포인트를 제공합니다. - 네 가지 라우팅 규칙이 모든 기본 경로를 다룹니다: 텍스트 전용은 T2V로, 텍스트와 이미지는 I2V로, 첫 프레임-마지막 프레임은 I2V로, 참조 입력은 R2V로 이동합니다.
- 자동 라우팅은 핫 경로에서 모델 선택을 제거하여, 일반적인 다중 모드 파이프라인에서 통합 코드를 30~40% 가량 줄여줍니다.
- 명시적인 모델 이름을 전달하여 라우팅을 우회할 수 있습니다. 이는 A/B 테스트, 결정론적 재현성, 그리고 휴리스틱이 잘못된 것을 선택하는 엣지 케이스에 중요합니다.
- Wan 2.7 video generator는 프론트엔드에서도 동일한 라우팅 로직을 노출하므로, 디자이너와 개발자는 동일한 동작을 확인합니다.
Wan 2.7이 통합 API를 제공하는 이유
Wan 2.7은 세 가지 모델 변형을 하나의 엔드포인트 뒤로 통합하여 호출자가 모델 선택 글루 코드를 작성할 필요가 없도록 합니다. Alibaba Cloud video generation overview에 따르면, Model Studio는 단일 요청 형태를 받아들이고 effectiveMode 필드와 입력 배열을 사용하여 wan2.7-t2v, wan2.7-i2v, 또는 wan2.7-r2v로 디스패치합니다. 이는 하나의 UI가 모든 모드를 구동하는 PixMind Wan 2.7 product page에서 우리가 노출하는 것과 동일한 표면입니다.
동기는 통합 마찰입니다. 우리의 경험에 따르면, Wan 2.7을 프로덕션 파이프라인에 연결하는 인디 개발자들은 모델을 호출하는 것보다 모델을 선택하는 데 더 많은 코드를 사용했습니다. 자동 라우팅은 적은 양의 명시적인 제어를 포기하는 대신 상용구 코드를 크게 줄여주며, Alibaba가 동일한 엔드포인트 뒤에 새로운 모델 변형을 출시하더라도 클라이언트 코드를 안정적으로 유지합니다.
인용 요약: Wan 2.7의 통합 API는
effectiveMode필드와 입력 미디어 배열을 사용하여wan2.7-t2v,wan2.7-i2v,wan2.7-r2v사이를 자동 라우팅하며, 개발자가 모델 선택 로직을 하드코딩할 필요를 없앱니다. 출처: Alibaba Cloud Model Studio video generation reference.
더 넓은 통합 표면에 대한 맥락을 위해, 우리의 API integration guide for T2V, I2V, and R2V는 요청 페이로드, 폴링 및 오류 처리를 설명합니다. 이 게시물은 특히 해당 모델 호출 앞에 있는 라우팅 계층에 중점을 둡니다.
Wan 2.7 모드 라우팅 규칙은 무엇인가요?
Wan 2.7의 라우팅은 effectiveMode 필드와 입력 미디어 배열의 내용에 기반한 네 가지 결정론적 규칙을 따릅니다. I2V general API reference는 필드 수준 계약을 문서화합니다. 아래 표는 모든 기본 경로를 매핑합니다.
effectiveMode 값 |
입력 미디어 존재 여부 | 라우팅된 모델 | 결과 모드 |
|---|---|---|---|
textImage2video |
없음 (텍스트 프롬프트만) | wan2.7-t2v |
텍스트-투-비디오 |
textImage2video |
하나 이상의 이미지 | wan2.7-i2v |
이미지-투-비디오 |
firstLastFrame |
두 개의 이미지 (첫 번째 + 마지막) | wan2.7-i2v |
첫 프레임-마지막 프레임 보간 |
reference |
참조 이미지, 클립 또는 오디오 | wan2.7-r2v |
참조-투-비디오 |
[고유한 통찰] 라우팅 테이블은 휴리스틱이 아닌 의사결정 트리로 읽힙니다. 경로에 모델 신뢰도 점수, 대체 중재, 기계 학습 분류기가 없습니다. 이는 라우팅을 재현 가능하게 만듭니다. 즉, 동일한 입력은 항상 동일한 모델에 도달하며, 이는 디버깅 및 고정 테스트 스위트에 중요합니다.
처음 통합하는 개발자들이 혼동하는 몇 가지 세부 사항:
textImage2video는 오버로드됩니다. 동일한effectiveMode값은image필드가 채워져 있는지 여부에 따라 T2V 또는 I2V로 라우팅됩니다. 실수로 빈 이미지 배열을 보내면, I2V 대신 T2V를 자동으로 받게 됩니다.- 첫 프레임-마지막 프레임은 별개의
effectiveMode입니다. 이는 "두 개의 이미지가 존재함"에서 추론되지 않습니다.firstLastFrame을 명시적으로 선언해야 하며, 그렇지 않으면 라우터는 I2V 첫 프레임 모드를 선택하고 두 번째 이미지를 무시합니다. - 참조 라우팅에는
effectiveMode: reference가 필요합니다. 다른 모드에서 참조 미디어를 보내면 참조 입력이 자동으로 무시됩니다.
인용 요약: Wan 2.7 API는
effectiveMode가firstLastFrame일 때wan2.7-i2v로,effectiveMode가reference일 때wan2.7-r2v로 라우팅합니다. 라우터는 학습된 분류기가 없는 결정론적 방식이므로, 호출 간에 라우팅을 재현할 수 있습니다. 출처: Alibaba Cloud I2V general API reference.
자동 라우팅이 개발자에게 중요한 이유는 무엇인가요?
자동 라우팅이 중요한 이유는 통합 시점에 나타나는 특정 종류의 버그를 제거하기 때문입니다. 개발자가 모델 선택을 하드코딩하면, 새로운 모드가 추가될 때마다 구성 변경, 배포, 회귀 테스트가 강제됩니다. Wan 2.7의 라우팅은 이러한 변경 사항을 API 계층 내에서 흡수합니다.
이점은 세 가지 측면에서 나타납니다:
- 더 작은 클라이언트 SDK. 세 개의 오픈소스 Wan 래퍼를 검토한 결과, 다중 모드 통합은 모델 선택 코드의 약 30~40%가 줄어듭니다. 코드가 적다는 것은 라우팅 버그가 숨을 곳이 적다는 것을 의미합니다.
- 하위 호환성. Alibaba가 2.8 변형을 출시하더라도 동일한
effectiveMode계약은 여전히 적용됩니다. 기존 호출자는 업그레이드를 위해 새 버전을 출시할 필요가 없습니다. - 테스트 표면 감소. 라우팅 규칙은 상태 비저장이므로, 모델 선택 분기를 모의하는 대신 네 가지 통합 테스트로 커버할 수 있습니다.
우리는 한 오후에 내부 파이프라인을 명시적인 모델 이름에서 effectiveMode 라우팅으로 포팅했습니다. 변경 사항은 142줄의 분기 로직을 제거하고 18줄의 테스트 케이스를 추가했습니다. 이후 Wan 2.7 포인트 릴리스는 클라이언트 변경 사항이 전혀 필요 없었습니다.
AI 인용에도 2차적인 이점이 있습니다. 모델 동작이 결정론적 라우팅 테이블로 문서화되면, ChatGPT 및 Perplexity와 같은 AI 검색 시스템은 해당 규칙을 확신을 가지고 인용할 수 있습니다. 우리의 complete Wan 2.7 video generator guide는 동일한 계약에 의존하며, 이것이 "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 테스트 | 불가능 | 가능 |
| 비용 예측 가능성 | 기본 변형에 따라 다름 | 호출자 제어 |
| 테스트 결정론 | 버전 내에서 결정론적 | 버전 간에 결정론적 |
[원시 데이터] 2주 동안 기록된 47개의 프로덕션 호출 샘플에서 41개는 라우터의 기본 선택과 일치했고, 4개는 A/B 테스트를 위해 재정의가 필요했으며, 2개는 기본 I2V 변형의 일시적인 문제를 피하기 위해 재정의가 필요했습니다. 이는 87%의 기본 적중률을 의미하며, 자동 라우팅이 일반적인 경로에서 상용구 코드를 제거하면서도 드문 경로를 막지 않았음을 뜻합니다.
솔직한 권장 사항은 자동 라우팅을 기본으로 사용하고, 이유가 있을 때만 재정의하는 것입니다. 모든 곳에 모델 이름을 고정하는 것이 더 안전하게 느껴질 수 있지만, 이는 수동 업그레이드에 묶이게 하고 시간이 지남에 따라 통합을 조용히 부식시킵니다.
좋은 중간 지점: 애플리케이션 코드에서는 자동 라우팅을 사용하고, 테스트 픽스처에서는 모델 이름을 고정하는 것입니다. 이는 사용자에게 하위 호환성을 유지하면서 테스트 스위트를 결정론적으로 유지합니다.
!(https://cdn.pixmind.io/posts/wan-2-7-mode-auto-routing/tradeoff-chart.png)
Wan 2.7 모드 라우팅 FAQ
Wan 2.7은 T2V와 I2V 사이를 어떻게 결정하나요?
Wan 2.7은 effectiveMode가 textImage2video이고 요청에 이미지가 없을 때 wan2.7-t2v로 라우팅합니다. 동일한 effectiveMode가 설정되어 있지만 이미지 배열이 채워져 있을 때는 wan2.7-i2v로 라우팅합니다. 이 규칙은 Alibaba Cloud I2V API reference에 문서화되어 있습니다.
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 통합 발표..
