Introduzione a ServBay AI Gateway

ServBay AI Gateway è un gateway locale unificato per provider AI integrato in ServBay. Esegue un endpoint proxy sulla tua macchina e convoglia in un unico punto di accesso le richieste dirette ai vari fornitori di modelli (OpenAI, Anthropic, DeepSeek, Qwen e quasi altri venti), aiutandoti a gestire centralmente le chiavi, a tenere traccia di utilizzo e costi e a indirizzare con un solo clic strumenti di programmazione AI come Claude Code e Codex verso il gateway locale.

Questo documento spiega che cos'è l'AI Gateway, quali problemi risolve e come è strutturato. Per le operazioni pratiche consulta:

• Gestione dei canali — Aggiungere e configurare i vari provider
• Chiavi virtuali — Creare, limitare, ruotare e revocare le chiavi
• Presa in carico con un clic degli strumenti di programmazione AI — Indirizzare CLI come Claude Code verso il gateway
• Statistiche e monitoraggio — Utilizzo, costi e budget
• Endpoint e variabili d'ambiente — Chiamare il gateway dal tuo codice

Panoramica

Nello sviluppo AI quotidiano capita spesso di possedere chiavi API di più provider, sparse tra progetti diversi e nei file di configurazione di strumenti diversi: diventa difficile sia tenere traccia della spesa sia passare da un provider all'altro in modo uniforme. ServBay AI Gateway raccoglie tutti questi problemi in un unico punto:

• Un solo ingresso, più provider — Dopo aver configurato i vari canali, tutte le richieste vengono inoltrate attraverso l'indirizzo locale http://127.0.0.1:11580 e la tua applicazione deve conoscere un solo indirizzo.
• Chiavi virtuali al posto delle chiavi reali — Il gateway emette "chiavi virtuali" da distribuire ad applicazioni e strumenti; le vere chiavi API dei provider restano solo sul lato del gateway e non sono più sparse ovunque. Le chiavi virtuali possono essere limitate, ruotate o revocate in qualsiasi momento.
• Una vista unificata su utilizzo e costi — Tutte le richieste che passano dal gateway vengono registrate; il gateway offre statistiche su numero di richieste, consumo di token, costi, latenza e utilizzo multimodale, con supporto alla gestione del budget.
• Presa in carico con un clic dei principali strumenti di programmazione AI — Senza modificare manualmente i file di configurazione, il gateway può indirizzare verso di sé strumenti come Claude Code, Codex, Qwen Code, Kimi CLI, CodeBuddy, opencode e Crush.
• Account in abbonamento e monitoraggio delle quote — Supporta il collegamento di account provider basati su abbonamento (ad esempio l'autorizzazione OAuth di Claude Pro / Max), mostrando all'interno del gateway le informazioni sul piano, gli endpoint disponibili e i limiti di lunghezza dell'output, oltre a monitorare in tempo reale le quote su più finestre (percentuale utilizzata/residua, stato di esaurimento, orario di reset), così sai sempre a quanto ammonta il saldo dell'abbonamento.
• Rilevamento delle capacità dei canali e routing intelligente — Quando aggiungi un canale, il gateway rileva automaticamente le capacità del provider (tipo con autorizzazione OAuth / tipo con piano di coding / tipo con modelli a livelli); dopo la conferma, in base al risultato del rilevamento vengono scritte automaticamente le mappature del gateway sui tre livelli, senza dover indovinare manualmente la compatibilità dei modelli.

Architettura e porte

L'AI Gateway è composto da due servizi locali, entrambi in ascolto esclusivamente sull'indirizzo di loopback (127.0.0.1):

Porta	Scopo	Descrizione
11580	Porta proxy	Punto di accesso unificato per le applicazioni. Il tuo codice e gli strumenti AI presi in carico inviano qui le richieste; il gateway le instrada verso il canale del provider corrispondente in base ai permessi della chiave virtuale.
11581	Porta di amministrazione	Usata internamente dall'applicazione ServBay per gestire canali, chiavi e statistiche; in genere non è necessario accedervi direttamente.

La porta proxy espone endpoint compatibili con diversi formati (compatibile OpenAI, compatibile Anthropic, compatibile Gemini); per i dettagli vedi Endpoint e variabili d'ambiente.

Canali provider supportati

L'AI Gateway include quasi 20 preset di provider, raggruppati per categoria e selezionabili direttamente al momento di aggiungere un canale:

• Principali (Mainstream): OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
• Cina (China): DeepSeek, Qwen (Tongyi Qianwen), Zhipu GLM, Kimi (Moonshot), Doubao · Volcano, ERNIE Bot (Wenxin Yiyan), Hunyuan, MiniMax, 01.AI (Yi), StepFun. Tra questi, Qwen, Zhipu GLM, Kimi, Doubao · Volcano, Hunyuan, MiniMax e StepFun supportano la commutazione tra endpoint per la Cina continentale e endpoint globali.
• Locali (Local): Ollama (predefinito 127.0.0.1:11434), LM Studio (predefinito 127.0.0.1:1234).
• Personalizzati (Custom): OpenAI Compatible (qualsiasi servizio compatibile con OpenAI), Custom (completamente personalizzato).

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

Prerequisiti

• ServBay installato e in esecuzione su macOS o Windows.
• L'AI Gateway è una funzionalità a valore aggiunto di ServBay: prima di aggiungere canali o chiavi è necessario accedere con il proprio account ServBay. Se non hai effettuato l'accesso, l'interfaccia ti guiderà nella procedura.

TIP

L'AI Gateway offre funzionalità identiche su ServBay for macOS e ServBay for Windows: la porta proxy (11580), la porta di amministrazione (11581) e i percorsi dei file di configurazione degli strumenti presi in carico sono gli stessi. Eventuali differenze tra piattaforme saranno indicate separatamente nella documentazione.

Account e piani

Alcune funzionalità dell'AI Gateway sono legate al piano del tuo account ServBay:

• Limiti al numero di canali e chiavi — I piani gratuiti e a pagamento consentono di creare un numero diverso di canali e chiavi virtuali. Al raggiungimento del limite l'interfaccia propone di effettuare l'upgrade.
• Gestione di quote e budget — I limiti per quota (token / numero di richieste / importo) e il pannello del budget sono funzionalità VIP/a pagamento; senza abbonamento le sezioni corrispondenti restano bloccate e invitano all'upgrade.

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

Account in abbonamento e monitoraggio delle quote

L'AI Gateway supporta il collegamento di account provider basati su abbonamento (come Claude Pro / Max collegati tramite autorizzazione OAuth), permettendoti di visualizzare e gestire queste risorse in abbonamento direttamente dal gateway locale, senza dover accedere alla console web di ciascun provider.

Cosa puoi fare con un account in abbonamento

• Informazioni sul piano a colpo d'occhio — Mostra il nome del piano di abbonamento, la struttura di fatturazione e la data di scadenza.
• Endpoint disponibili e limiti di output — Consulta l'elenco degli endpoint richiamabili con quell'account e i limiti massimi di lunghezza dell'output per ciascun modello.
• Monitoraggio delle quote su più finestre — Mostra in forma visuale la percentuale di quota utilizzata/residua, se la quota è attualmente esaurita e quando verrà reimpostata, aiutandoti a distribuire al meglio le risorse dell'abbonamento.
• Visibilità sulla scadenza delle credenziali — Quando le credenziali di autorizzazione dell'account scadono o diventano non valide, l'interfaccia lo segnala chiaramente invitandoti a ripetere l'autorizzazione.

Funzionalità sperimentale

Al momento il collegamento tramite autorizzazione OAuth degli account in abbonamento è una funzionalità sperimentale e i provider supportati verranno ampliati gradualmente. Durante l'autorizzazione dovrai completare il flusso OAuth del provider nel browser; il token di autorizzazione viene memorizzato solo in locale.

Archiviazione dei dati

• I dati come configurazione dei canali, chiavi virtuali e statistiche di utilizzo sono mantenuti localmente dal servizio backend del gateway.
• La chiave virtuale in chiaro viene mostrata una sola volta, al momento della creazione (o della rotazione); in seguito il gateway conserva solo il prefisso per identificarla. Assicurati di copiarla e salvarla subito dopo la creazione.
• Quando prendi in carico uno strumento con un clic, il gateway esegue prima un backup del file di configurazione originale dello strumento con estensione .bak, poi vi scrive la configurazione che punta al gateway locale, così puoi ripristinarla in qualsiasi momento.

Flusso d'uso tipico

1. Accedi al tuo account ServBay e apri AI Gateway.
2. Nella pagina Canali aggiungi almeno un canale provider (ad esempio OpenAI o DeepSeek), inserisci la chiave API reale e verifica la connettività.
3. Nella pagina Chiavi virtuali crea una chiave virtuale e, se necessario, limita modelli/canali e frequenza.
4. Nella pagina Endpoint inserisci la chiave virtuale nella tua applicazione oppure, dalla stessa pagina, usa la presa in carico con un clic per gli strumenti di programmazione AI che usi abitualmente.
5. Nella pagina Statistiche e monitoraggio osserva utilizzo, costi e latenza e, se serve, imposta un budget.

Conclusione

ServBay AI Gateway riunisce la frammentazione dello sviluppo AI fatta di «più provider, più chiavi, più strumenti» in «un unico ingresso locale, un unico set di chiavi virtuali, un'unica vista sull'utilizzo». Ti permette di gestire in modo sicuro e centralizzato le capacità AI direttamente in locale, di tenere sotto controllo i costi con precisione e di collegare al gateway unificato ogni tipo di strumento di programmazione AI con il minimo sforzo: è una delle capacità chiave di ServBay per lo sviluppo AI-native.