Introductie tot de ServBay AI Gateway
De ServBay AI Gateway is een lokale, uniforme AI-leveranciersgateway die standaard in ServBay zit. Deze draait als een proxy-eindpunt op je eigen machine. Verzoeken naar bijna 20 verschillende grote AI-leveranciers (waaronder OpenAI, Anthropic, DeepSeek en Qwen) worden via één lokale ingang gerouteerd. Zo kun je API-sleutels centraal beheren, het verbruik en de kosten bijhouden, en jouw favoriete AI-programmeer-CLI-tools als Claude Code, Codex en Gemini CLI eenvoudig laten verwijzen naar de lokale gateway.
In dit document lees je wat de AI Gateway is, welke problemen het oplost en krijg je inzicht in de architectuur. Voor stapsgewijze instructies, zie:
- Kanalen beheren — Toevoegen en configureren van leveranciers
- Virtuele sleutels — Aanmaken, machtigen, draaien en intrekken van sleutels
- Eén-klik integratie voor AI-programmeertools — Tools als Claude Code met één klik naar de gateway verwijzen
- Statistieken & monitoring — Verbruik, kosten en budgetbeheer
- Eindpunten & omgevingsvariabelen — De gateway gebruiken in je eigen code
Overzicht
Bij de dagelijkse ontwikkeling met AI werk je mogelijk met API Keys van meerdere leveranciers, verspreid over verschillende projecten en toolconfiguraties. Dit maakt het lastig uitgaven te beheren en snel te wisselen tussen leveranciers. ServBay AI Gateway centraliseert dit:
- Één ingang voor meerdere leveranciers — Stel je kanalen eenmalig in en alle verzoeken lopen via
http://127.0.0.1:11580. Je applicaties hoeven maar met één adres te werken. - Virtuele sleutels ter vervanging van echte API-keys — De gateway verstrekt “virtuele sleutels” voor je applicaties en tools. De unieke, echte leverancierssleutels worden alleen binnen de gateway opgeslagen, niet elders verspreid. Virtuele sleutels kun je op elk moment machtigen, draaien of intrekken.
- Gecombineerd overzicht van verbruik & kosten — Alle via de gateway verstuurde verzoeken worden gelogd. De gateway biedt statistieken over het aantal verzoeken, tokengebruik, kosten, latency en multimodaal verbruik, en ondersteunt budgetbeheer.
- Snelle overname van toonaangevende AI-programmeertools — Geen handmatige aanpassingen meer in config-bestanden: met één klik verwijs je Claude Code, Codex, Gemini CLI, Qwen Code, Kimi CLI, CodeBuddy, opencode, Crush en meer direct naar je lokale gateway.
Architectuur & Poorten
De AI Gateway bestaat uit twee lokale services, die beide uitsluitend luisteren op het loopback-adres (127.0.0.1):
| Poort | Gebruik | Toelichting |
|---|---|---|
11580 | Proxy-poort | Het uniforme ingangspunt voor applicaties. Je code en overgenomen AI-tools sturen hun verzoeken hierheen, waarna de gateway het verzoek op basis van virtuele sleutelmachtigingen doorstuurt naar de juiste leverancier. |
11581 | Management-poort | Voor intern gebruik door de ServBay-app zelf om kanalen, sleutels en statistieken te beheren. Je hoeft deze poort doorgaans niet direct te benaderen. |
De proxy-poort ondersteunt verschillende compatibele eindpuntformaten (OpenAI-compatibel, Anthropic-compatibel, Gemini-compatibel). Zie Eindpunten & omgevingsvariabelen voor details.
Ondersteunde leverancierskanalen
Er zijn bijna 20 voorgeconfigureerde leveranciers in de AI Gateway, gegroepeerd per categorie voor eenvoudige selectie:
- Mainstream: OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
- China: DeepSeek, Qwen, Zhipu GLM, Kimi (Moonshot), Doubao Volc, Wenxin Yiyan, Hunyuan, MiniMax, ZeroOne, StepStar. Bij leveranciers zoals Qwen, Zhipu GLM, Kimi, Doubao Volc, Hunyuan, MiniMax en StepStar kun je wisselen tussen endpoints in China of wereldwijd.
- Lokaal: Ollama (standaard
127.0.0.1:11434), LM Studio (standaard127.0.0.1:1234). - Aangepast: OpenAI Compatible (voor iedere OpenAI-compatibele service), Custom (volledig naar eigen wens).
Bekijk Kanalen beheren voor een volledig stappenplan.
Vereisten
- Je hebt ServBay al geïnstalleerd en actief op macOS of Windows.
- De AI Gateway is een premium functie; een ServBay-account login is vereist vóór het toevoegen van kanalen of sleutels. Indien niet ingelogd, word je via de interface begeleid.
TIP
De AI Gateway werkt hetzelfde op ServBay voor macOS en Windows: de proxy-poort (11580), management-poort (11581) en de locatie van config-bestanden voor tools zijn op beide platforms identiek. Mochten er platformspecifieke uitzonderingen zijn, dan vermeldt de documentatie dit expliciet.
Account & Abonnementen
Sommige mogelijkheden van de AI Gateway zijn afhankelijk van je ServBay-accountniveau:
- Maximum aantal kanalen/sleutels — Er geldt een limiet voor het aantal kanalen en virtuele sleutels in gratis en betaalde abonnementen. Bij het bereiken van de limiet geeft de interface melding en kun je upgraden.
- Limieten & budgetbeheer — Limieten (voor tokens, request-aantallen, bedragen) en budgetmeters zijn VIP/betaalde functies. Wanneer je deze niet afneemt, zijn de betreffende secties vergrendeld met een upgradeverwijzing.
Zie ServBay Pro en ServBay Team voor details.
Opslag van gegevens
- Kanaalconfiguraties, virtuele sleutels, verbruiksstatistieken en gerelateerde data worden lokaal beheerd door de gateway-backend.
- Virtuele sleutels worden slechts éénmalig als platte tekst getoond bij aanmaken of roteren. Daarna bewaart de gateway alleen het prefix om je sleutel te herkennen. Kopieer de sleutel dus direct bij aanmaak!
- Als je tools laat overnemen, maakt de gateway altijd eerst een
.bak-back-up van het originele config-bestand, waarna het configuratiebestand wordt aangepast naar de lokale gateway. Zo kun je altijd eenvoudig terug naar de oude situatie.
Typische workflow
- Log in op je ServBay-account en open de AI Gateway.
- Voeg op de pagina Kanalen ten minste één kanaal toe (bijv. OpenAI of DeepSeek), vul de geldige API Key in en test de verbinding.
- Maak op de pagina Virtuele sleutels een virtuele sleutel aan en stel indien nodig beperkingen in voor toegestane modellen/kanalen en snelheid.
- Vul je virtuele sleutel in bij je applicaties via de Eindpunten-pagina, of neem je favoriete AI-programmeertools direct over via Eén-klik integratie.
- Zie op de pagina Statistieken & monitoring alle data over verbruik, kosten en latency en stel een budgetlimiet in indien nodig.
Samenvatting
Met ServBay AI Gateway breng je een einde aan de versnippering van “meerdere leveranciers, sleutels en tools” in je AI-ontwikkelomgeving. Je krijgt één lokale ingang, één set virtuele sleutels en één centraal verbruiksoverzicht. Hierdoor kun je niet alleen AI-capaciteiten centraal beheren en de kosten onder controle houden, maar koppel je ook al je favoriete AI-programmeertools tegen minimale inspanning aan de uniforme gateway. Het is een van de kernfunctionaliteiten van ServBay voor AI-native development.
