Sobre o projeto
New API é um gateway auto-hospedado e sistema de gerenciamento para APIs de modelos de linguagem grandes, posicionado como sucessor de próxima geração do projeto One API. Ele agrega muitos provedores de modelos upstream atrás de um único endpoint e normaliza seus diferentes formatos de requisição/resposta, para que os clientes possam falar com uma única superfície de API enquanto o gateway cuida da tradução.
Principais recursos descritos no README:
- Conversão de formatos: OpenAI-compatível ⇄ Claude Messages, OpenAI-compatível → Google Gemini e Gemini → OpenAI-compatível (somente texto, chamada de funções ainda não suportada). A conversão de OpenAI Responses está listada como em desenvolvimento. Um recurso de "thinking-to-content" também é mencionado.
- Cobertura de interfaces: chat completions, Responses, imagens, áudio, vídeo, embeddings, rerank (Cohere, Jina), sessões em tempo real (incluindo Azure), Claude Messages e chat do Google Gemini. Midjourney-Proxy, Suno API e Dify ChatFlow também são listados como tipos upstream suportados, além de endpoints upstream personalizados configuráveis.
- Roteamento e confiabilidade: seleção aleatória ponderada de canais, repetição automática em caso de falha e limite de taxa de modelos por usuário.
- Controles de esforço de raciocínio: sufixos no nome do modelo como -high/-medium/-low para a série o da OpenAI e GPT-5, uma variante -thinking para Claude e sufixos thinking/nothinking e de orçamento para modelos Gemini.
- Contas e acesso: agrupamento de tokens, restrições de modelo, gerenciamento de usuários e login de autorização via Discord, LinuxDO, Telegram e OIDC. Uma ferramenta complementar de consulta de cota de chaves é referenciada.
- Contabilidade: recarga interna e alocação de cotas via EPay e Stripe, contabilidade de custos por requisição e por uso, e estatísticas de cobrança por cache-hit para provedores como OpenAI, Azure, DeepSeek, Claude e Qwen.
- Operações: painel visual com estatísticas, interface multilíngue (chinês simplificado/tradicional, inglês, francês, japonês) e compatibilidade de banco de dados com o esquema original do One API.
A implantação é centrada em Docker: um arquivo docker-compose é fornecido, e execuções de contêiner único são documentadas para SQLite (padrão, requer montagem de /data) ou MySQL. PostgreSQL ≥ 9.6 e MySQL ≥ 5.7.8 são suportados como bancos de dados remotos; apenas amd64/arm64 de 64 bits é suportado. Uma instalação com um clique no painel BaoTa também é documentada. Configurações de vários nós exigem um banco de dados primário compartilhado e SESSION_SECRET idêntico, e nós que compartilham Redis também devem compartilhar CRYPTO_SECRET. O README detalha o tratamento de sessão em topologias com Redis compartilhado, Redis por nó e sem Redis, incluindo janelas de obsolescência e como os limites de taxa se comportam em cada caso. Numerosas variáveis de ambiente são documentadas para timeouts, limites de corpo de requisição, buffer de stream, proxies confiáveis, limites de sessão e profiling com Pyroscope.
O projeto é licenciado sob AGPLv3 com termos adicionais da Seção 7 que exigem a preservação de um aviso de atribuição e um link visível para o repositório original em versões modificadas. É derivado do One API (MIT). O README enfatiza que o uso é destinado a cenários lícitos e autorizados de gateway, gerenciamento de múltiplos modelos, análise e implantação privada, e que operadores que oferecem serviços públicos de IA generativa devem cumprir as obrigações aplicáveis de registro, licenciamento, segurança de conteúdo e relacionadas.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.