Sub2API

O que é o Sub2API?

Sub2API é uma plataforma de API gateway de IA open-source que ajuda a distribuir e gerenciar cotas de API de assinaturas de produtos de IA. Em vez de cada usuário integrar diretamente com serviços de IA upstream, o Sub2API fornece chaves de API geradas pela plataforma enquanto gerencia autenticação, contabilidade relacionada a faturamento, balanceamento de carga e encaminhamento de requisições.

O projeto é projetado para configurações onde várias contas upstream precisam ser agrupadas e servidas por meio de um gateway consistente, incluindo recursos como suporte a múltiplas contas, agendamento consciente de cotas e controles para concorrência e limitação de taxa.

Principais Recursos

• Gerenciamento de múltiplas contas para conexões upstream (suporta vários tipos de contas upstream, como OAuth e API Key), permitindo que um gateway sirva várias contas upstream.
• Distribuição de chaves de API (gerar e gerenciar chaves de API para usuários), para que os usuários se autentiquem no Sub2API em vez de gerenciar múltiplas credenciais upstream.
• Rastreamento de uso em nível de token e cálculo de custos, usado para rastrear e calcular uso em nível de token para contabilidade relacionada a faturamento.
• Agendamento inteligente com sessões fixas, que seleciona contas upstream de forma inteligente enquanto mantém o roteamento de sessão estável em ambientes multi-conta.
• Controle de concorrência e limitação de taxa configurável (limites de concorrência por usuário e por conta; limites de taxa de requisições e tokens), para evitar sobrecarga e gerenciar throughput.
• Painel administrativo para monitoramento e gerenciamento via interface web.
• Integração com sistemas externos para estender o painel administrativo usando iframes (ex.: incorporação de sistemas de pagamento ou bilhetagem).

Como Usar o Sub2API

1. Decida se deseja hospedar sozinho ou usar o serviço de relay oficial. O repositório menciona um relay oficial, PinCC, para usuários que não querem hospedar sozinhos.
2. Se hospedando sozinho, instale o Sub2API em um servidor Linux (amd64 ou arm64) com PostgreSQL 15+ e Redis 7+ disponíveis.
3. Instale usando o script de um clique fornecido no repositório, depois inicie o serviço e habilite-o na inicialização.
4. Abra o assistente de configuração no navegador (o README referencia http://YOUR_SERVER_IP:8080) para configurar as configurações de banco de dados/Redis e criar uma conta administrativa.
5. No painel administrativo, gerencie configurações e chaves de API de usuários; os usuários então chamam serviços de IA upstream por meio da plataforma usando suas chaves de API emitidas pelo Sub2API.

Casos de Uso

• Agrupamento de múltiplas contas de assinatura upstream: use o Sub2API para centralizar o uso de cotas e servir usuários por meio de um único gateway enquanto distribui requisições entre contas upstream.
• Distribuição de cotas para equipes: forneça chaves de API individuais do Sub2API para membros da equipe enquanto o Sub2API rastreia uso em nível de token e gerencia agendamento e limites.
• Gerenciamento de throughput com limites: configure limites de concorrência por usuário e por conta, além de limites de taxa de requisições/tokens, para moldar a carga e reduzir o risco de saturação upstream.
• Visibilidade operacional e administração: use o painel administrativo integrado para monitorar e gerenciar o gateway em vez de depender apenas de painéis de provedores upstream.
• Estendendo fluxos de trabalho internos: incorpore sistemas externos (como pagamento ou bilhetagem) no painel administrativo usando iframes para suportar processos operacionais.

FAQ

• O Sub2API está vinculado a um domínio específico? O repositório afirma que o Sub2API usa oficialmente apenas sub2api.org e pincc.ai. Outros sites usando o nome Sub2API podem ser implantações de terceiros e não são afiliados; os usuários devem verificar de forma independente.

• Como implanto o Sub2API? O projeto documenta dois métodos de implantação: instalar via script que baixa binários pré-construídos do GitHub Releases, ou implantar com Docker Compose (incluindo contêineres PostgreSQL e Redis).

• Quais contas upstream o Sub2API suporta? Suporta vários tipos de contas upstream, incluindo OAuth e API Key (conforme listado nos recursos).

• O que devo fazer ao usar Nginx como proxy reverso? O README observa que, se você usar Nginx com Sub2API (ou CRS) e Codex CLI, deve adicionar underscores_in_headers on; dentro do bloco http, porque o Nginx descarta cabeçalhos contendo underscores por padrão e isso pode quebrar o roteamento de sessões fixas em configurações multi-conta.

Alternativas

• Use o serviço de relay oficial (PinCC): se você não quiser hospedar o Sub2API por conta própria, o repositório aponta para o PinCC como o relay oficial construído sobre o Sub2API, destinado a usuários que querem acesso pronto sem implantação/manutenção.
• Use uma API gateway auto-gerenciada para cotas e roteamento: se você já executa infraestrutura, pode procurar soluções de gateway/gerenciamento de rotas que suportem chaves de API, autenticação, limitação de taxa e encaminhamento de requisições; ao contrário do Sub2API, elas podem não incluir rastreamento de uso em nível de token e distribuição de cotas orientada para assinaturas de IA.
• Crie um serviço de proxy personalizado: você pode implementar um proxy em camada de aplicação que roteia requisições para provedores de IA upstream e impõe limites; em comparação com o Sub2API, isso geralmente exige mais trabalho de engenharia para recursos como sessões sticky e contabilidade em nível de token.
• Use uma abordagem de gerenciamento de API multi-tenant: plataformas gerais de gerenciamento de API podem centralizar autenticação e throttling, mas podem exigir customização adicional para corresponder à distribuição de cotas e fluxo de contabilidade de uso baseado em token do Sub2API.