Repolode
tbphp

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. 1

    저장소를 클론합니다

    git clone --depth 1 https://github.com/tbphp/gpt-load.git
  2. 2

    프로젝트 디렉터리로 이동한 다음 환경 템플릿을 복사합니다

    cd gpt-load && cp .env.example .env
  3. 3

    Docker Compose로 서비스를 시작합니다

    docker compose up -d
  4. 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 통계는 매일 갱신됩니다.

관련 프로젝트