tbphp/gpt-load

O que é?

Recursos principais

• 01Ponto de entrada único com interfaces nativas da OpenAI, Anthropic e Gemini.
• 02Gerencia credenciais de API e de assinatura com um único mecanismo de escalonamento.
• 03Escalonamento ponderado de várias credenciais, com novas tentativas, períodos de espera e lista de bloqueio.
• 04Registros de solicitações, painéis de integridade e estatísticas de uso e custo em uma interface integrada.
• 05Usa SQLite por padrão, com suporte a MySQL e PostgreSQL.

Casos de uso

• Agrupar várias chaves de API de um provedor para distribuir a carga e contornar limites de taxa.
• Fornecer à equipe uma AccessKey por aplicação, com restrições de grupo e protocolo.
• Encaminhar o tráfego do Claude Code ou Codex por um gateway auto-hospedado com acompanhamento de uso.
• Alternar entre APIs oficiais e relays compatíveis sem alterar o código da aplicação.

Início rápido

1. 1

   Clone o repositório

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

   Entre no diretório do projeto e copie o modelo de ambiente

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

   Inicie o serviço com Docker Compose

   docker compose up -d
4. 4

   Acesse http://127.0.0.1:3001, consulte no contêiner a chave de gerenciamento gerada e entre no console

Antes de usar

• !Para configurar tudo mais rapidamente, é necessário ter Docker e Docker Compose.
• !Não é possível atualizar diretamente da versão 1.x: a 2.0 não consegue abrir nem migrar dados da 1.x.
• !Se perder encryption.key, não será possível recuperar as credenciais de canais armazenadas, e a rotação da chave mestra não é compatível.

Tópicos

Perguntas frequentes

O que é gpt-load?

Gateway de IA auto-hospedado que reúne chaves de API e contas de assinatura de vários provedores em um único endpoint, com escalonamento, failover e registros de uso. O GPT-Load é um gateway auto-hospedado que fica entre suas aplicações e serviços de IA upstream. As aplicações precisam apenas de uma URL base e uma AccessKey, enquanto provedores, contas, credenciais, modelos e políticas de roteamento são configurados em uma interface de gerenciamento integrada.

gpt-load é gratuito? Qual é a licença?

gpt-load é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

gpt-load ainda é mantido?

Manutenção ativa. O último commit de gpt-load foi em 20 de out. de 2026.

Para que posso usar gpt-load?

Agrupar várias chaves de API de um provedor para distribuir a carga e contornar limites de taxa. Fornecer à equipe uma AccessKey por aplicação, com restrições de grupo e protocolo. Encaminhar o tráfego do Claude Code ou Codex por um gateway auto-hospedado com acompanhamento de uso. Alternar entre APIs oficiais e relays compatíveis sem alterar o código da aplicação.

Como instalar gpt-load?

Clone o repositório: git clone --depth 1 https://github.com/tbphp/gpt-load.git Entre no diretório do projeto e copie o modelo de ambiente: cd gpt-load && cp .env.example .env Inicie o serviço com Docker Compose: docker compose up -d Acesse http://127.0.0.1:3001, consulte no contêiner a chave de gerenciamento gerada e entre no console

Onde consigo gpt-load?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/tbphp/gpt-load