Sub2API

Cos'è Sub2API?

Sub2API è una piattaforma open-source gateway API AI che aiuta a distribuire e gestire le quote API dalle sottoscrizioni di prodotti AI. Invece di far integrare ogni utente direttamente con i servizi AI upstream, Sub2API fornisce chiavi API generate dalla piattaforma mentre gestisce autenticazione, contabilità relativa alla fatturazione, bilanciamento del carico e inoltro delle richieste.

Il progetto è progettato per configurazioni in cui più account upstream devono essere raggruppati e serviti tramite un unico gateway coerente, inclusi funzionalità come supporto multi-account, scheduling consapevole delle quote e controlli per concorrenza e rate limiting.

Caratteristiche Principali

• Gestione multi-account per connessioni upstream (supporta più tipi di account upstream come OAuth e API Key), consentendo a un unico gateway di servire diversi account upstream.
• Distribuzione chiavi API (genera e gestisce chiavi API per gli utenti), così gli utenti si autenticano con Sub2API invece di gestire multiple credenziali upstream.
• Tracking uso a livello di token e calcolo costi, per tracciare e calcolare l'uso a livello di token per la contabilità relativa alla fatturazione.
• Scheduling intelligente con sticky sessions, che seleziona account upstream in modo intelligente mantenendo il routing delle sessioni stabile in ambienti multi-account.
• Controllo concorrenza e rate limiting configurabile (limiti di concorrenza per utente e per account; limiti di rate per richieste e token), per prevenire sovraccarichi e gestire il throughput.
• Dashboard admin per monitoraggio e gestione tramite interfaccia web.
• Integrazione con sistemi esterni per estendere la dashboard admin usando iframe (es. embedding di sistemi di pagamento o ticketing).

Come Usare Sub2API

1. Decidi se vuoi auto-ospitarlo o usare il servizio relay ufficiale. Il repository menziona un relay ufficiale, PinCC, per utenti che non vogliono auto-ospitarsi.
2. Se auto-ospiti, installa Sub2API su un server Linux (amd64 o arm64) con PostgreSQL 15+ e Redis 7+ disponibili.
3. Installa usando lo script one-click fornito dal repository, poi avvia il servizio e abilitalo all'avvio.
4. Apri il wizard di setup nel browser (il README fa riferimento a http://YOUR_SERVER_IP:8080) per configurare impostazioni database/Redis e creare un account admin.
5. Dalla dashboard admin, gestisci impostazioni e chiavi API utente; gli utenti chiamano poi i servizi AI upstream tramite la piattaforma usando le loro chiavi API emesse da Sub2API.

Casi d'Uso

• Raggruppamento più account sottoscrizione upstream: usa Sub2API per centralizzare l'uso delle quote e servire gli utenti tramite un unico gateway distribuendo le richieste tra account upstream.
• Distribuzione quote per team: dai ai membri del team chiavi API individuali Sub2API mentre Sub2API traccia l'uso a livello di token e gestisce scheduling e limiti.
• Gestione throughput con limiti: configura limiti di concorrenza per utente e per account più limiti di rate richieste/token per modellare il carico e ridurre il rischio di saturazione upstream.
• Visibilità operativa e amministrazione: usa la dashboard admin integrata per monitorare e gestire il gateway invece di affidarsi solo alle dashboard dei provider upstream.
• Estensione workflow interni: incorpora sistemi esterni (come pagamento o ticketing) nella dashboard admin usando iframe per supportare processi operativi.

FAQ

• Sub2API è legato a un dominio specifico? Il repository afferma che Sub2API usa ufficialmente solo sub2api.org e pincc.ai. Altri siti che usano il nome Sub2API potrebbero essere deployment di terze parti e non sono affiliati; gli utenti dovrebbero verificare indipendentemente.

• Come deployo Sub2API? Il progetto documenta due metodi di deployment: installazione via script che scarica binari pre-compilati da GitHub Releases, o deployment con Docker Compose (inclusi container PostgreSQL e Redis).

• Quali account upstream supporta Sub2API? Supporta più tipi di account upstream, inclusi OAuth e API Key (come indicato nella lista delle feature).

• Cosa fare quando uso Nginx come reverse proxy? Il README nota che se usi Nginx con Sub2API (o CRS) e Codex CLI, dovresti aggiungere underscores_in_headers on; all'interno del blocco http, perché Nginx elimina di default gli header contenenti underscore e ciò può rompere il routing sticky-session in setup multi-account.

Alternative

• Usa il servizio relay ufficiale (PinCC): se non vuoi auto-ospitare Sub2API, il repository indica PinCC come relay ufficiale basato su Sub2API, pensato per utenti che vogliono accesso pronto senza deployment/manutenzione.
• Usa un gateway API self-managed per quote e routing: se gestisci già infrastruttura, puoi cercare soluzioni di gateway/gestione route che supportino chiavi API, autenticazione, rate limiting e forwarding richieste; a differenza di Sub2API, potrebbero non includere tracking uso a livello token e distribuzione quote orientata a sottoscrizioni AI.
• Costruisci un servizio proxy custom: puoi implementare un proxy application-layer che instrada richieste a provider AI upstream e impone limiti; rispetto a Sub2API, richiede tipicamente più lavoro ingegneristico per feature come sticky sessions e contabilità a livello token.
• Usa un approccio di gestione API multi-tenant: piattaforme generali di gestione API possono centralizzare auth e throttling, ma potrebbero richiedere customizzazioni extra per eguagliare la distribuzione quote e il workflow di contabilità uso basato su token di Sub2API.