TokenDance: 하나의 Base URL로 여러 중국 대형 모델에 연결하는 API 게이트웨이

AI 제품을 만드는 사람은 같은 단계를 거칩니다. 한 제공사로 흐름을 검증하고, 품질이나 비용 때문에 두 번째, 세 번째를 붙입니다. 그러면 코드에 적응 계층이 생기고, 키는 여러 콘솔에 흩어지고, 청구서는 다른 계정에 나뉘고, 한 곳이 흔들리면 누군가 손으로 엔드포인트를 바꿉니다. TokenDance가 겨냥하는 것이 이 마찰입니다. 여러 제공사를 하나의 Base URL 뒤에 두고 애플리케이션은 단일 진입점만 봅니다.

구조 자체는 특별하지 않습니다. 외부로는 OpenAI, Claude, Gemini 세 가지 주요 프로토콜 형태를 노출하고, 내부에서는 모델 이름으로 해당 제공사 엔드포인트에 라우팅합니다. 개발자가 바꾸는 것은 코드가 아니라 설정이며, 이 점이 무이전이라는 주장을 성립시킵니다. 이미 OpenAI SDK를 쓰는 프로젝트라면 Base URL 한 줄로 중국 모델을 시험할 수 있어 시행착오 비용이 크게 낮아집니다.

나머지 가치는 운영 쪽에 있습니다. 같은 모델에 여러 엔드포인트를 두면 한 제공사 장애 시 자동 전환됩니다. 요청 한 번에 후보 모델을 여러 개 지정해 주 모델이 안 될 때 단계적으로 물러설 수도 있습니다. 통합 과금은 제공사를 넘나드는 토큰 소비를 한 장의 청구서로 모아 개별 충전과 대사를 없앱니다. 요율, 요청 한도, 서비스 수준 약속, 데이터 보관 정책은 공개되지 않아 도입 전에 제공사에 확인해야 합니다.

주요 기능

프로토콜 호환

OpenAI, Claude, Gemini를 기본 지원해 Base URL만 바꾸면 연결되고 비즈니스 코드는 그대로입니다. 기존 프로젝트에는 가장 실용적인 부분으로, 새 모델을 시험하려고 호출 계층을 다시 만들 필요가 없습니다.

스마트 라우팅

요청의 모델 이름으로 해당 엔드포인트에 자동 라우팅하고, 단일 진입점이 하위 제어를 감춥니다. 호출하는 쪽이 제공사별 도메인과 파라미터 차이를 외울 필요가 없습니다.

통합 과금

제공사를 넘나드는 토큰 소비를 집계해 한곳에서 청구합니다. 여러 콘솔에 따로 충전할 필요가 없고, 비용을 설명할 때 청구서 한 장이 다섯 장보다 쉽습니다.

자동 전환과 단계적 축소

같은 모델에 여러 제공사 엔드포인트를 두어 자동 전환하고, 요청 단위로 후보 모델을 지정해 순서대로 물러설 수 있습니다. 직접 연동 대비 게이트웨이의 가장 현실적인 장점입니다.

모델 범위

MiniMax, Qwen, Kimi, Zhipu, DeepSeek 등 8개 이상의 중국 주요 모델이 연결되어 있고 계속 확장 중입니다. 범위는 중국 주력 모델이며 전 세계 전체 목록은 아닙니다.

빠른 시작

Watcha 원클릭 로그인으로 가입과 인증을 마치고 기존 SDK도 그대로 동작해 도입이 분 단위로 끝납니다. 다만 그 로그인은 특정 계정 체계에 묶이므로 받아들여야 하는 전제입니다.

지원 프로그램

제품 단계에 따라 토큰 지원을 신청하는 양식이 있습니다. 초기 프로젝트에는 유용하지만 한도와 심사 기준은 공개되지 않았습니다.

도입 단계

1. TokenDance 사이트에 접속해 Watcha 원클릭 로그인으로 가입과 인증을 마칩니다.
2. 콘솔에서 개인 API 키를 발급하고 자격 증명처럼 안전하게 보관합니다.
3. 기존 프로젝트의 Base URL을 게이트웨이 주소 https://tokendance.space/gateway/v1/ 로 바꿉니다.
4. 요청에 대상 모델 ID(예: DeepSeek, Kimi)를 넣습니다.
5. 기존 OpenAI SDK나 curl로 요청을 보내 응답이 기대와 맞는지 확인합니다.
6. 대량 토큰이 필요하면 지원 프로그램 신청서를 작성해 제품 단계에 따라 지원을 요청합니다.

적합한 사용자

• 여러 중국 모델을 낮은 비용으로 비교하려는 초기 팀.
• 운영 환경에서 작업 유형별로 모델을 나눠 쓰는 제품(추론, 작성, 코드).
• 고가용성과 단계적 축소를 갖춘 모델 기반이 필요한 에이전트 개발.
• 비용에 민감해 통합 과금을 활용하려는 교육, 연구, 개인 개발자.

한계

• 요율, 무료 한도, 요청 한도, 서비스 수준 약속이 공개되지 않았습니다. 도입 전에 제공사에 확인해야 합니다.
• 계정은 Watcha 원클릭 로그인이 필수여서 해당 체계를 받아들여야 합니다. 기업 아이디 관리 연동은 설명이 없습니다.
• 게이트웨이가 요청 내용을 거치며 데이터 보관과 로그 정책이 제시되지 않아 민감 데이터는 규정 검토가 필요합니다.
• 모델 목록은 중국 주요 모델 중심이라 해외 모델이나 틈새 오픈 모델은 부족할 수 있습니다.
• 한 단계 더 거치므로 지연과 장애 지점이 늘어납니다. 자동 전환이 있어도 자체 모니터링은 필요합니다.
• 지원 한도, 심사 기준, 지속성은 비공개라 장기 비용 모델의 근거로 삼기 어렵습니다.

자주 묻는 질문

코드를 고쳐야 하나요?

비즈니스 코드는 아닙니다. Base URL을 게이트웨이 주소로 바꾸고 API 키와 모델 ID를 넣으면 기존 OpenAI SDK 호출 방식을 유지할 수 있습니다.

어떤 모델을 쓸 수 있나요?

MiniMax, Qwen, Kimi, Zhipu, DeepSeek 등 8개 이상의 중국 주요 모델이 연결되어 있고 계속 확장 중입니다. 최종 목록은 콘솔이 기준입니다.

자동 전환은 어떻게 동작하나요?

두 단계입니다. 모델별로 여러 엔드포인트를 두어 자동 전환하고, 요청 단위로 후보 모델을 지정해 주 모델 실패 시 순서대로 물러섭니다.

각 제공사에 직접 붙이는 것과 무엇이 다른가요?

직접 연동은 키, 충전, 요청 한도, 장애 전환을 제공사마다 관리합니다. 게이트웨이는 이를 하나의 진입점과 한 장의 청구서로 모으지만, 경로가 한 단계 늘고 게이트웨이 가용성에 의존합니다.

무료 한도가 있나요?

원문은 제품 단계에 따라 신청하는 지원 프로그램만 언급하며 일반 무료 한도는 제시하지 않았습니다. 제공사에 확인해야 합니다.