호환성 매트릭스
도구 및 SDK 호환성
코딩 도구, 채팅 앱, SDK 및 프레임워크에 맞는 TokenLab 설정 찾기
대부분의 도구는 API 키와 기본 URL을 변경해 TokenLab에 연결할 수 있습니다. 구체적인 설정은 도구에서 사용할 수 있는 API 형식에 따라 달라집니다.
| API 형식 | 기본 URL | 주요 클라이언트 |
|---|---|---|
| Chat Completions (OpenAI 호환) | https://api.tokenlab.sh/v1 | OpenAI SDK, 여러 채팅 앱 및 프레임워크 |
| OpenAI Responses | https://api.tokenlab.sh/v1 | Responses 클라이언트 및 Responses 이벤트를 사용하는 도구 |
| Anthropic Messages | https://api.tokenlab.sh | Anthropic SDK 및 Claude용 도구 |
| Gemini | https://api.tokenlab.sh | 사용자 지정 호스트를 지원하는 Gemini REST 또는 SDK 클라이언트 |
선택한 모델의 accepted_request_formats에 같은 형식이 포함되어야 합니다. 스트리밍과 도구 호출도 모델 기능과 클라이언트 지원에 따라 달라집니다. 예시는 API 형식을 참고하세요.
호환성 상태
| 상태 | 의미 |
|---|---|
| 사용 가능 | 연결된 페이지의 TokenLab 설정은 클라이언트가 공식 문서에서 제공하는 설정 옵션을 사용합니다 |
| 일부 제한 있음 | 설정은 특정 기능이나 인증 방식에 적용되며, 공급업체의 다른 서비스에는 각각의 이용 조건이 적용됩니다 |
이 상태는 연결된 페이지의 설정 방식을 설명합니다. 실제 기능의 사용 가능 여부는 선택한 모델과 클라이언트 버전에도 달려 있습니다.
코딩 도구
| 도구 | 상태 | API 형식 | 설명 |
|---|---|---|---|
| Claude Code | 사용 가능 | Anthropic Messages | ANTHROPIC_BASE_URL과 TokenLab API 키 사용 |
| Codex CLI | 일부 제한 있음 | Responses | Responses 사용. 사용 가능한 기능은 선택한 모델에 따라 다름 |
| Cursor | 일부 제한 있음 | OpenAI 호환 | 사용자 지정 API 키와 URL을 허용하는 Cursor 기능에 적용 |
| Cline | 사용 가능 | OpenAI 호환 | OpenAI Compatible을 선택하고 기본 URL과 모델 ID 입력 |
| Kilo Code | 사용 가능 | OpenAI 호환 | 사용자 지정 공급자와 모델 ID 설정 |
| OpenCode | 사용 가능 | OpenAI 호환 | OPENCODE_CONFIG로 별도의 공급자 설정 로드 |
| OpenHands | 사용 가능 | OpenAI 호환 | LiteLLM 기반 UI: Advanced → Custom Model(openai/ 접두사) 및 Base URL |
| Gemini CLI | 일부 제한 있음 | Gemini | API 키 인증에서 GOOGLE_GEMINI_BASE_URL 사용. 별도의 GEMINI_CLI_HOME으로 기존 설정 유지 |
채팅 앱
| 앱 | 상태 | 설명 |
|---|---|---|
| Chatbox | 사용 가능 | OpenAI API Compatible 공급자 추가 |
| Cherry Studio | 사용 가능 | 공급자를 추가하고 Verify and Enable 완료 |
| DeepChat | 사용 가능 | Chat Completions를 사용하려면 OpenAI Completions 선택 |
| Jan | 사용 가능 | OpenAI 호환 서비스 추가 |
| LibreChat | 사용 가능 | 사용자 지정 OpenAI 호환 엔드포인트 설정 |
| Open WebUI | 사용 가능 | OpenAI 호환 연결을 추가하고 API Type을 Chat으로 선택 |
SDK 및 프레임워크
| 클라이언트 | 상태 | 설정 |
|---|---|---|
| OpenAI SDK | 사용 가능 | base_url / baseURL을 https://api.tokenlab.sh/v1로 설정 |
| Anthropic SDK | 사용 가능 | 기본 URL을 https://api.tokenlab.sh로 설정 |
| Vercel AI SDK | 사용 가능 | 사용자 지정 OpenAI 호환 공급자 생성 |
| LangChain | 사용 가능 | ChatOpenAI 또는 OpenAIEmbeddings에 TokenLab URL 설정 |
| LlamaIndex | 사용 가능 | OpenAI 호환 클라이언트 옵션 사용 |
| OpenAI Agents SDK | 일부 제한 있음 | 가이드는 OpenAIChatCompletionsModel 사용. Responses 사용 전 모델과 SDK의 기능 지원 확인 |
| AutoGen | 사용 가능 | OpenAI 호환 모델 클라이언트 사용 |
| CrewAI | 사용 가능 | OpenAI 호환 LLM 클라이언트 설정 |
| PydanticAI | 사용 가능 | OpenAI 호환 공급자 지정 |
다른 프레임워크, 관측 도구, 게이트웨이 및 평가 제품은 Integrations 탐색 메뉴에서 찾을 수 있습니다.
스트리밍 응답의 사용량
Chat Completions 스트림은 stream_options: { include_usage: true }를 허용하며 스트림이 끝나기 전에 마지막 사용량 청크를 추가합니다. Responses API는 include_usage를 제공하지 않으며, Responses 스트림은 종료 이벤트에 사용량을 포함합니다.
사용자 지정 API 키로 대체할 수 없는 항목
일부 제품은 모델 호출과 함께 공급업체가 호스팅하는 기능을 제공합니다. TokenLab 키는 BYOK 설정에서 허용하는 모델 요청에 사용할 수 있지만, 별도의 구독, 자동 완성 서비스, 계정 기능 또는 독점 확장 기능을 대체하지는 않습니다.
도구 업데이트로 설정 방식이 바뀌면 오래된 환경 변수 예시를 복사하지 말고 현재 통합 페이지를 참고하세요.
기능 사용 전 확인 사항
- 도구가 필요한 형식에 사용자 지정 기본 URL을 허용하는지 확인하세요.
- 모델의
accepted_request_formats에 해당 형식이 포함되는지 확인하세요. - 워크플로에 필요하다면 스트리밍과 도구 호출을 확인하세요.
- API 키는 신뢰할 수 있는 기기 또는 서버에 보관하세요.
- 오류를 보고할 때 요청 ID를 기록하세요.