여러 업스트림 모델 제공업체를 대상으로 라우팅, 키, 할당량, 비용 추적을 제공하며 OpenAI, Claude, Gemini 호환 API를 노출하는 셀프 호스팅 AI 게이트웨이입니다.
tbphp/gpt-load
여러 공급자의 API 키와 구독 계정을 하나의 엔드포인트로 통합하고, 스케줄링·장애 조치·사용량 로그를 제공하는 셀프 호스팅 AI 게이트웨이입니다.
대체할 수 있는 제품:OpenRouter
- 스타
- 7,150
- 포크
- 812
- 열린 이슈
- 10
- 마지막 커밋
- 14시간 전
어떤 프로젝트인가요?
GPT-Load는 애플리케이션과 업스트림 AI 서비스 사이에서 동작하는 셀프 호스팅 게이트웨이입니다. 애플리케이션은 기본 URL과 AccessKey 하나만 사용하면 되며, 공급자, 계정, 자격 증명, 모델, 라우팅 정책은 내장 관리 UI에서 설정합니다.
OpenAI, Anthropic, Gemini의 기본 프로토콜로 요청을 받아 공식 API, 클라우드 플랫폼, 모델 서비스 및 호환 릴레이로 전달합니다. API 키 채널과 Codex, Claude, Antigravity, Grok 같은 구독 채널은 하나의 자격 증명 관리, 스케줄링, 상태 처리 메커니즘을 공유합니다. 스케줄링은 가중치, 재시도, 쿨다운, 블랙리스트, 세션 선호도를 지원합니다.
요청 로그, 상태, 토큰 사용량, 예상 비용을 기록합니다. 기본적으로 SQLite를 사용하며 MySQL이나 PostgreSQL도 사용할 수 있고, 로컬 자격 증명은 저장 시 암호화됩니다.
핵심 기능
- 01OpenAI, Anthropic, Gemini의 기본 인터페이스를 제공하는 단일 진입점입니다.
- 02API 키와 구독 자격 증명을 하나의 스케줄링 메커니즘으로 관리합니다.
- 03재시도, 쿨다운, 블랙리스트를 지원하는 가중치 기반 다중 자격 증명 스케줄링을 제공합니다.
- 04내장 UI에서 요청 로그, 상태, 사용량 및 비용 통계를 확인할 수 있습니다.
- 05기본적으로 SQLite를 사용하며 MySQL과 PostgreSQL도 지원합니다.
활용 사례
- 한 공급자의 API 키 여러 개를 묶어 부하를 분산하고 속도 제한에도 안정적으로 대응합니다.
- 그룹 및 프로토콜 제한을 적용해 애플리케이션별 AccessKey 하나를 팀에 제공합니다.
- 사용량을 추적하면서 Claude Code 또는 Codex 트래픽을 셀프 호스팅 게이트웨이로 전달합니다.
- 애플리케이션 코드를 변경하지 않고 공식 API와 호환 릴레이 사이에서 전환합니다.
빠른 시작
- 1
저장소를 클론합니다
git clone --depth 1 https://github.com/tbphp/gpt-load.git - 2
프로젝트 디렉터리로 이동한 다음 환경 템플릿을 복사합니다
cd gpt-load && cp .env.example .env - 3
Docker Compose로 서비스를 시작합니다
docker compose up -d - 4
http://127.0.0.1:3001을 열고 컨테이너에서 생성된 관리 키를 확인한 다음 콘솔에 로그인합니다
사용 전 알아둘 점
- 가장 빠르게 설정하려면 Docker와 Docker Compose가 필요합니다.
- 1.x에서 바로 업그레이드할 수 없습니다. 2.0에서는 1.x 데이터를 열거나 마이그레이션할 수 없습니다.
- encryption.key를 분실하면 저장된 채널 자격 증명을 복구할 수 없으며, 마스터 키 로테이션은 지원되지 않습니다.
토픽
자주 묻는 질문
- gpt-load은(는) 무엇인가요?
- 여러 공급자의 API 키와 구독 계정을 하나의 엔드포인트로 통합하고, 스케줄링·장애 조치·사용량 로그를 제공하는 셀프 호스팅 AI 게이트웨이입니다. GPT-Load는 애플리케이션과 업스트림 AI 서비스 사이에서 동작하는 셀프 호스팅 게이트웨이입니다. 애플리케이션은 기본 URL과 AccessKey 하나만 사용하면 되며, 공급자, 계정, 자격 증명, 모델, 라우팅 정책은 내장 관리 UI에서 설정합니다.
- gpt-load은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- gpt-load은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- gpt-load은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. gpt-load의 마지막 커밋은 2026년 10월 20일입니다.
- gpt-load은(는) 어디에 사용할 수 있나요?
- 한 공급자의 API 키 여러 개를 묶어 부하를 분산하고 속도 제한에도 안정적으로 대응합니다. 그룹 및 프로토콜 제한을 적용해 애플리케이션별 AccessKey 하나를 팀에 제공합니다. 사용량을 추적하면서 Claude Code 또는 Codex 트래픽을 셀프 호스팅 게이트웨이로 전달합니다. 애플리케이션 코드를 변경하지 않고 공식 API와 호환 릴레이 사이에서 전환합니다.
- gpt-load는 어떻게 설치하나요?
- 저장소를 클론합니다: git clone --depth 1 https://github.com/tbphp/gpt-load.git 프로젝트 디렉터리로 이동한 다음 환경 템플릿을 복사합니다: cd gpt-load && cp .env.example .env Docker Compose로 서비스를 시작합니다: docker compose up -d http://127.0.0.1:3001을 열고 컨테이너에서 생성된 관리 키를 확인한 다음 콘솔에 로그인합니다
- gpt-load은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/tbphp/gpt-load
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
OpenAI, Claude, Gemini, DeepSeek 및 자체 호스팅 모델에 연결할 수 있는 오픈소스 크로스 플랫폼 AI 채팅 클라이언트로, 웹·데스크톱·모바일을 지원합니다.
Codex, Claude Code, Claude Desktop, Grok Build에서 어떤 LLM 제공자든 사용할 수 있게 해 주는 로컬 프록시입니다.
프롬프트에 `ulw` 또는 `mass ulw`라는 키워드 하나를 넣으면 계획을 세우고 여러 모델에 작업을 분담한 뒤 결과를 검증하는 TypeScript 코딩 에이전트 CLI입니다.
여러 AI 제공자를 통합하고 Agents, MCP, Artifacts, 다중 사용자 인증을 지원하는 셀프 호스팅 채팅 플랫폼
로컬에 데이터를 저장하며 Windows, macOS, Linux에서 실행되는 ChatGPT, Claude 및 기타 LLM용 데스크톱 클라이언트입니다.