AI 채팅 애플리케이션

개요

대부분의 일반 AI 채팅 앱은 표준 OpenAI 호환 채팅 경로를 통해 TokenLab에 연결됩니다. 실제 적용 시 다음 사항을 참고하세요:

앱에서 전체 엔드포인트 URL을 명시적으로 요구하지 않는 한, 기본 URL로 https://api.tokenlab.sh/v1을 사용하세요.
TokenLab API 키를 OpenAI 스타일의 API 키로 사용하세요.
앱의 표준 채팅 워크플로우에서 사용할 수 있는 모델을 선택하세요.

일반 채팅 앱은 대개 chat-completions 지향적이며, Codex Responses WebSocket 클라이언트가 아닙니다. Codex CLI/App, Cursor 또는 Responses 전용 동작이 필요한 기타 코딩 도구의 경우, 대신 전용 통합 가이드를 사용하세요.

유형: 채팅 앱기본 경로: OpenAI 호환 chat-completions지원 신뢰도: 지원되는 경로

지원되는 애플리케이션

애플리케이션	플랫폼	참고 사항
Open WebUI	웹, 자체 호스팅	OpenAI 호환 연결을 지원하는 인기 있는 자체 호스팅 선택지
LibreChat	웹, 자체 호스팅	사용자 지정 OpenAI 엔드포인트를 지원하는 다중 공급자 채팅 워크스페이스
LobeChat	웹, 데스크톱, 자체 호스팅	강력한 사용자 지정 공급자 지원
Cherry Studio	Windows, macOS, Linux	우수한 OpenAI 호환 공급자 흐름
Chatbox	Windows, macOS, Linux	간단한 OpenAI 호환 설정
DeepChat	Windows, macOS, Linux	OpenAI 호환 공급자 설정이 포함된 데스크톱 클라이언트
Jan	데스크톱, 자체 호스팅	원격 OpenAI 호환 공급자를 지원하는 로컬 우선 앱
TypingMind	웹, 데스크톱	사용자 지정 엔드포인트 스타일 사용
NextChat	웹, 자체 호스팅	기본 URL 재정의가 가능한 경량 ChatGPT 스타일 클라이언트
ChatWise	Windows, macOS	표준 사용자 지정 공급자 패턴

기본 연결 값

필드	값
Base URL	`https://api.tokenlab.sh/v1`
API Key	`sk-your-tokenlab-key`
API Type	OpenAI Compatible

앱에서 기본 URL 대신 전체 엔드포인트 URL을 요구하는 경우 다음을 사용하세요:

Chat Completions: https://api.tokenlab.sh/v1/chat/completions

앱 설정 예시

자체 호스팅 LobeChat

OPENAI_API_KEY=sk-your-tokenlab-key
OPENAI_PROXY_URL=https://api.tokenlab.sh/v1

LobeChat Cloud

Settings → AI Service Provider를 엽니다.
OpenAI를 선택합니다.
TokenLab API 키를 입력합니다.
사용자 지정 엔드포인트를 https://api.tokenlab.sh/v1로 설정합니다.

Settings → Model Provider를 엽니다.
OpenAI-compatible 공급자를 추가합니다.
다음을 입력합니다:
- Name: TokenLab
- API Base URL: https://api.tokenlab.sh/v1
- API Key: sk-your-tokenlab-key
사용할 모델을 추가합니다.

Settings → AI Model을 엽니다.
OpenAI API Compatible을 선택합니다.
다음을 입력합니다:
- API Host: https://api.tokenlab.sh/v1
- API Key: sk-your-tokenlab-key
- Model: gpt-5.4-mini 또는 claude-sonnet-5

Settings를 엽니다.
Custom Endpoint를 선택합니다.
다음을 입력합니다:
- Endpoint URL: https://api.tokenlab.sh/v1/chat/completions
- API Key: sk-your-tokenlab-key
노출할 모델을 구성합니다.

Admin Settings → Connections를 엽니다.
OpenAI-compatible 연결을 추가합니다.
다음을 입력합니다:
- Base URL: https://api.tokenlab.sh/v1
- API Key: sk-your-tokenlab-key
저장하고 노출할 모델을 선택합니다.

Settings -> Model Provider를 엽니다.
OpenAI 호환 공급자를 추가합니다.
다음을 입력합니다:
- Base URL: https://api.tokenlab.sh/v1
- API Key: sk-your-tokenlab-key
- Model: gpt-5.4-mini
저장하고 테스트 채팅을 실행합니다.

Settings -> Providers를 엽니다.
원격 OpenAI 호환 공급자를 추가합니다.
다음을 입력합니다:
- Provider name: TokenLab
- Base URL: https://api.tokenlab.sh/v1
- API Key: sk-your-tokenlab-key
gpt-5.4-mini 또는 다른 TokenLab 모델을 선택합니다.

LibreChat 공급자 구성에 OpenAI 호환 엔드포인트를 추가하고 다음을 가리키도록 설정합니다:

customEndpoints:
  - name: TokenLab
    apiKey: '${OPENAI_API_KEY}'
    baseURL: 'https://api.tokenlab.sh/v1'
    models:
      default: ['gpt-5.4-mini', 'gpt-5.4', 'claude-sonnet-5']
      fetch: false

권장 모델 기본값

카테고리	추천 모델
일반 기본값	`gpt-5.4-mini`, `gpt-5.4`, `gpt-5.5`
Anthropic	`claude-sonnet-5`, `claude-opus-4-8`, `claude-fable-5`
Google	`gemini-3.5-flash`, `gemini-3.1-flash-lite`
DeepSeek	`deepseek-v4-flash`, `deepseek-v4-pro`

팁

앱에서 지원하는 경우 기본 URL 사용 권장

대부분의 앱은 전체 엔드포인트 URL 대신 https://api.tokenlab.sh/v1을 기본 URL로 제공할 때 구성이 더 쉽고 오류가 적습니다.

작은 모델부터 사용

일상적인 채팅에는 gpt-5.4-mini 또는 deepseek-v4-flash로 시작하고, 더 복잡한 추론 작업이 필요할 때 gpt-5.4 또는 claude-opus-4-8로 전환하세요.

코딩 도구는 별도로 관리

일반 채팅 앱과 코딩 에이전트는 종종 서로 다른 엔드포인트 동작을 필요로 합니다. Codex/Cursor 스타일의 도구는 전용 통합 페이지를 참조하세요.

문제 해결

연결 오류

기본 URL이 정확히 https://api.tokenlab.sh/v1인지 확인하세요.
앱이 경로를 자동으로 추가하는 경우 끝에 있는 슬래시(/)를 제거하세요.
앱에서 전체 엔드포인트 URL을 요구하는 경우 https://api.tokenlab.sh/v1/chat/completions를 사용하세요.

401 Unauthorized (인증 실패)

API 키를 다시 확인하세요.
TokenLab 대시보드에서 키가 활성화되어 있는지 확인하세요.
추가 공백이나 줄 바꿈이 없는지 확인하세요.

모델을 사용할 수 없음

모델 이름을 정확하게 확인하세요.
gpt-5.4-mini, deepseek-v4-flash 또는 claude-sonnet-5와 같이 널리 지원되는 기본 모델을 사용해 보세요.
TokenLab 문서나 대시보드에서 현재 가용성을 확인하세요.

​개요

​지원되는 애플리케이션

​기본 연결 값

​앱 설정 예시

​권장 모델 기본값

​팁

​문제 해결

개요

지원되는 애플리케이션

기본 연결 값

앱 설정 예시

권장 모델 기본값

팁

문제 해결