QuantumNous/new-api

O que é?

Recursos principais

• 01Oferece endpoints compatíveis com OpenAI, Anthropic Messages e Gemini para os mesmos modelos upstream
• 02Roteia solicitações entre vários canais com mapeamentos de modelos, prioridades, pesos e novas tentativas
• 03Gerencia usuários, grupos, chaves de API e cotas, com logs de uso e contabilização de custos
• 04Oferece suporte a OAuth/OIDC, passkeys e autenticação de dois fatores para o login no console
• 05Amplia APIs assíncronas de imagens, vídeos e outras tarefas por meio de plugins JavaScript

Casos de uso

• Compartilhar o acesso autorizado a modelos entre uma equipe, com cotas por usuário e acompanhamento do uso
• Trocar de provedores upstream sem reconfigurar cada aplicação cliente
• Executar um serviço privado com vários modelos e um console web para administradores

Início rápido

1. 1

   Inicie uma instância local com Docker (SQLite, vinculada a localhost).

   mkdir -p data docker run --name new-api -d --restart unless-stopped \ -p 127.0.0.1:3000:3000 \ -e TZ=Asia/Shanghai \ -v "$(pwd)/data:/data" \ calciumion/new-api:latest
2. 2

   Acesse http://localhost:3000 e conclua o assistente de configuração para criar a conta de administrador.

3. 3

   Adicione um canal com sua chave de API upstream, configure os modelos e os preços e, em seguida, crie uma nova chave de API.

4. 4

   Liste os modelos disponíveis usando sua chave.

   curl --fail-with-body http://localhost:3000/v1/models \ -H "Authorization: Bearer ${NEW_API_KEY}"

Antes de usar

• !Você precisa fornecer suas próprias chaves de API e contas upstream e cumprir os termos dos serviços upstream.
• !Oferecer publicamente ou revender IA generativa ou APIs envolve obrigações legais, de registro e de conformidade substanciais.
• !Licenciado sob AGPL-3.0, uma licença copyleft com requisitos de divulgação do código-fonte para uso pela rede.

Tópicos

Perguntas frequentes

O que é new-api?

Um gateway de IA self-hosted que oferece APIs compatíveis com OpenAI, Claude e Gemini para vários provedores de modelos, com roteamento, chaves, cotas e acompanhamento de custos. New API é um gateway self-hosted que fica entre suas aplicações e serviços de modelos upstream, como OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, Vertex AI e DeepSeek. Os clientes chamam uma API consistente, e o gateway faz a conversão entre os formatos OpenAI Chat/Responses, Anthropic Messages e Gemini.

new-api é gratuito? Qual é a licença?

new-api é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

new-api ainda é mantido?

Manutenção ativa. O último commit de new-api foi em 19 de out. de 2026.

Para que posso usar new-api?

Compartilhar o acesso autorizado a modelos entre uma equipe, com cotas por usuário e acompanhamento do uso Trocar de provedores upstream sem reconfigurar cada aplicação cliente Executar um serviço privado com vários modelos e um console web para administradores

Como instalar new-api?

Inicie uma instância local com Docker (SQLite, vinculada a localhost).: mkdir -p data docker run --name new-api -d --restart unless-stopped \ -p 127.0.0.1:3000:3000 \ -e TZ=Asia/Shanghai \ -v "$(pwd)/data:/data" \ calciumion/new-api:latest Acesse http://localhost:3000 e conclua o assistente de configuração para criar a conta de administrador. Adicione um canal com sua chave de API upstream, configure os modelos e os preços e, em seguida, crie uma nova chave de API. Liste os modelos disponíveis usando sua chave.: curl --fail-with-body http://localhost:3000/v1/models \ -H "Authorization: Bearer ${NEW_API_KEY}"

Onde consigo new-api?

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