fruitbars/simple-one-api

O que é?

Recursos principais

• 01Oferece endpoints OpenAI Chat Completions, Responses e Anthropic Messages por meio de um único gateway.
• 02Mantém várias chaves de API por provedor em pools, com roteamento round-robin, preferencial, aleatório e por hash.
• 03Estima a capacidade de tokens por chave e usa outra chave como fallback quando o serviço upstream retorna 429.
• 04Aplica limites em camadas de QPS, QPM, RPM, TPM e concorrência.
• 05Inclui um chat web integrado e um console de configuração com status das chaves em tempo real.
• 06Armazena a configuração no SQLite e fornece estatísticas de uso sem salvar o conteúdo dos prompts ou das respostas.

Casos de uso

• Compartilhar uma chave do gateway entre vários clientes locais, como Codex ou Claude Code.
• Distribuir tráfego intenso entre várias chaves upstream para reduzir erros 429.
• Executar um ponto de entrada privado e auto-hospedado para vários provedores chineses de LLM.
• Oferecer a uma equipe pequena um único endpoint compatível com OpenAI e visibilidade do uso.

Início rápido

1. 1

   Compile o executável único a partir do código-fonte

   ./quick_build.sh
2. 2

   Execute o gateway; não é necessário ter um config.json na configuração inicial

   ./simple-one-api
3. 3

   Abra http://localhost:9090/ no navegador e conclua o assistente de /setup

Antes de usar

• !Para compilar a partir do código-fonte, você precisa do Go 1.25 ou superior, Node.js e pnpm.
• !Preços, cotas gratuitas e detalhes dos modelos são fornecidos pelos provedores upstream e podem mudar; por isso, o README recomenda consultar a documentação oficial de cada um.

Em coleções

Tópicos

Perguntas frequentes

O que é simple-one-api?

Um gateway auto-hospedado que oferece acesso a vários provedores de LLM por endpoints compatíveis com OpenAI, Responses e Anthropic, distribuído como um único executável. simple-one-api é um gateway entre suas ferramentas cliente e vários provedores de modelos de linguagem de grande porte. Os clientes se comunicam com um único endpoint pelos protocolos OpenAI Chat Completions, OpenAI Responses ou Anthropic Messages, enquanto o gateway encaminha as solicitações para provedores configurados, como Qianfan, iFlytek Spark, Tencent Hunyuan, MiniMax e DeepSeek.

simple-one-api é gratuito? Qual é a licença?

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

simple-one-api ainda é mantido?

Atualizado nos últimos 6 meses. O último commit de simple-one-api foi em 29 de set. de 2026.

Para que posso usar simple-one-api?

Compartilhar uma chave do gateway entre vários clientes locais, como Codex ou Claude Code. Distribuir tráfego intenso entre várias chaves upstream para reduzir erros 429. Executar um ponto de entrada privado e auto-hospedado para vários provedores chineses de LLM. Oferecer a uma equipe pequena um único endpoint compatível com OpenAI e visibilidade do uso.

Como instalar simple-one-api?

Compile o executável único a partir do código-fonte: ./quick_build.sh Execute o gateway; não é necessário ter um config.json na configuração inicial: ./simple-one-api Abra http://localhost:9090/ no navegador e conclua o assistente de /setup

Onde consigo simple-one-api?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/fruitbars/simple-one-api