Introduzione a ServBay AI Gateway

ServBay AI Gateway è un gateway AI unificato per fornitori multipli, in esecuzione locale integrato in ServBay. Funziona come un endpoint proxy sulla tua macchina, incanalando tutte le richieste verso quasi 20 provider di modelli AI di grandi dimensioni (tra cui OpenAI, Anthropic, DeepSeek, Qwen, ecc.) attraverso un unico punto di accesso. Questo ti permette di gestire centralmente le chiavi API, monitorare l'utilizzo e i costi, oltre a indirizzare senza fatica strumenti CLI di programmazione AI come Claude Code, Codex, Gemini CLI direttamente verso il gateway locale con un clic.

Questo documento spiega cos'è l'AI Gateway, quali problemi risolve e la sua architettura generale. Per istruzioni specifiche, consulta:

• Gestione dei canali — Aggiungi e configura i vari provider
• Chiavi virtuali — Crea, limita, ruota e revoca chiavi
• Reindirizzamento strumenti di programmazione AI — Punta CLI come Claude Code al gateway
• Statistiche e monitoraggio — Utilizzo, costi e budget
• Endpoint e variabili d'ambiente — Integra il gateway nel tuo codice

Panoramica

Nello sviluppo quotidiano con l’AI, può capitare di possedere diverse API Key di vari provider, disseminate tra i file di configurazione di progetti e strumenti diversi, rendendo difficile il controllo della spesa o la rotazione centralizzata. ServBay AI Gateway centralizza queste problematiche:

• Un unico punto di accesso verso più provider — Dopo aver configurato i tuoi canali, tutte le richieste passano attraverso http://127.0.0.1:11580, così le tue applicazioni si interfacciano solo con questo indirizzo.
• Chiavi virtuali invece delle chiavi reali — Il gateway genera "chiavi virtuali" da fornire alle app e agli strumenti. Le vere API key dei provider sono custodite solo lato gateway, senza essere sparse ovunque. Le chiavi virtuali possono essere limitate, ruotate o revocate in qualsiasi momento.
• Vista unificata su utilizzo e costi — Ogni richiesta che passa dal gateway viene tracciata. Il gateway offre statistiche su richieste, token utilizzati, costi, latenza e anche dati multimodali, con gestione del budget integrata.
• Reindirizzamento strumenti AI più diffusi con un clic — Non occorre modificare manualmente file di configurazione: il gateway può reindirizzare istantaneamente Claude Code, Codex, Gemini CLI, Qwen Code, Kimi CLI, CodeBuddy, opencode, Crush e altro verso l’endpoint locale.

Architettura e porte

L’AI Gateway è composto da due servizi locali che ascoltano solo sull’indirizzo di loopback (127.0.0.1):

Porta	Scopo	Descrizione
11580	Porta proxy	Punto di accesso unificato per le applicazioni. Le tue app e strumenti AI reindirizzati inviano qui le richieste, che il gateway inoltra ai provider sulla base dei permessi delle chiavi virtuali.
11581	Porta di gestione	Utilizzata dall’applicazione ServBay per la gestione interna di canali, chiavi e statistiche; di solito non è necessario accedervi direttamente.

La porta proxy offre vari endpoint compatibili (OpenAI, Anthropic, Gemini, ecc.). Maggiori dettagli su Endpoint e variabili d'ambiente.

Provider supportati

AI Gateway include quasi 20 provider preimpostati, suddivisi per categoria, selezionabili direttamente in fase di aggiunta del canale:

• Mainstream: OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
• Cina: DeepSeek, Qwen, Zhipu GLM, Kimi (Moonshot AI), Doubao-Volcano, Wenxin Yiyan, Hunyuan, MiniMax, Lingyi Wanwu, StepStar. Alcuni (Qwen, Zhipu GLM, Kimi, Doubao-Volcano, Hunyuan, MiniMax, StepStar) supportano doppia regione locale/globale.
• Locale: Ollama (default 127.0.0.1:11434), LM Studio (default 127.0.0.1:1234).
• Personalizzato: OpenAI Compatible (qualsiasi servizio compatibile OpenAI), Custom (completamente personalizzato).

Per la procedura completa di aggiunta/configurazione, vedi Gestione dei canali.

Prerequisiti

• ServBay installato e attivo su macOS o Windows.
• L’AI Gateway è una funzionalità extra di ServBay: devi effettuare l'accesso al tuo account ServBay prima di aggiungere canali o chiavi. In caso contrario, l’interfaccia guida automaticamente al login.

TIP

AI Gateway offre le stesse funzionalità sia su ServBay per macOS che per Windows; le porte proxy (11580), gestione (11581) e i percorsi dei file di configurazione degli strumenti reindirizzati sono identici. Eventuali differenze specifiche tra piattaforme verranno segnalate nella documentazione.

Account e Piani

Alcune funzionalità dell’AI Gateway dipendono dal piano ServBay collegato al tuo account:

• Limiti su canali/per chiavi — I piani free e a pagamento prevedono diversi limiti nel numero di canali e chiavi virtuali creabili. Al raggiungimento del limite, l’interfaccia suggerisce l’upgrade.
• Gestione quote e budget — Restrizioni su quote (token, numero richieste, importo speso) e cruscotto-budget sono funzioni VIP/a pagamento; senza abbonamento, le relative sezioni risultano bloccate e invitano all’upgrade.

Per dettagli sui piani, consulta ServBay Pro e ServBay Team.

Archiviazione dati

• La configurazione dei canali, le chiavi virtuali e le metriche di utilizzo sono gestite localmente dal backend del gateway.
• Le chiavi virtuali in chiaro vengono mostrate solo una volta al momento della creazione o rotazione: in seguito, il gateway conserva solo il prefisso delle chiavi come identificatore, quindi assicurati di copiarle/subito al momento della creazione.
• Durante il reindirizzamento degli strumenti, il gateway crea prima un backup del file di configurazione originale con suffisso .bak, poi sovrascrive la configurazione per puntare al gateway locale, così puoi sempre ripristinare la situazione precedente.

Tipico flusso di utilizzo

1. Accedi al tuo account ServBay e accedi all’AI Gateway.
2. Nella pagina Canali, aggiungi almeno un provider (ad esempio OpenAI o DeepSeek), inserisci la vera API key e testa la connessione.
3. Nella pagina Chiavi virtuali crea una chiave virtuale e limita, se serve, i modelli o canali e il rate di accesso.
4. Nella pagina Endpoint inserisci la chiave virtuale nella tua app, oppure, sempre dalla stessa pagina, reindirizza con un clic i tuoi strumenti CLI AI preferiti.
5. Nella pagina Statistiche e monitoraggio analizza consumo, costi e latenza, impostando dove necessario i tuoi budget.

Conclusioni

ServBay AI Gateway trasforma lo sviluppo AI da una gestione frammentata tra provider, chiavi e strumenti diversi, a una soluzione centralizzata: un unico endpoint locale, un set di chiavi virtuali, una vista integrata dell’utilizzo. Così puoi gestire in modo sicuro e preciso sia le capacità AI che i costi, e integrare ogni strumento di programmazione AI con il minimo sforzo, facendo di questa una delle funzionalità chiave di ServBay per gli sviluppatori AI-native.