Kanalen beheren in de AI Gateway

Een kanaal in de AI Gateway is een configuratie van een leveranciersonderningspunt: het bevat het adres van de leverancier, de echte API Key, beschikbare modellen, prijsinformatie en quotabeperkingen. De gateway gebruikt deze kanalen om verzoeken van applicaties naar de juiste leverancier te routeren. In dit artikel lees je hoe je kanalen toevoegt, configureert, test en beheert.

Vereisten

• ServBay is geïnstalleerd, draait en je bent ingelogd op jouw ServBay-account (je moet ingelogd zijn om kanalen toe te voegen).
• De echte API Key van de gewenste leverancier is beschikbaar (voor lokale leveranciers als Ollama / LM Studio is dit meestal niet vereist).
• Als je nog niet bekend bent met de algemene architectuur van de AI Gateway, lees dan eerst de introductie van de AI Gateway.

Kanaal toevoegen

Ga naar AI Gateway → Kanalen (Channels) en klik op Toevoegen (Add) om de wizard te openen. De wizard bestaat uit drie stappen.

Stap 1: Kies leverancier

Leveranciers zijn per categorie gegroepeerd; klik op een kaart om te selecteren:

• Mainstream: OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
• China: DeepSeek, Qwen, GLM, Kimi, Doubao·Volcano, Wenxin Yiyan, Hunyuan, MiniMax, ZeroOne, StepStar.
• Lokaal (Local): Ollama, LM Studio.
• Aangepast (Custom): OpenAI Compatibel, Custom.

Na selectie vult de gateway automatisch de standaard Base URL van deze leverancier in.

Dual-regio wissel

Chinese leveranciers zoals Qwen, GLM, Kimi, Doubao·Volcano, Hunyuan, MiniMax en StepStar bieden zowel Mainland China als Global endpoints. Bij deze keuze toont de wizard een regiokiezer (🇨🇳 Mainland / 🌐 Global). Na omschakelen past de Base URL zich automatisch aan per regio.

Stap 2: Configuratie invoeren

• Kanaalnaam (verplicht) — Persoonlijke naam voor het kanaal, getoond in de lijst.
• Base URL (verplicht) — API-adres van de leverancier. Voor de meeste leveranciers is dit vooraf ingevuld; Azure OpenAI en Custom vereisen handmatige invoer.
• API Key (optioneel) — Echte sleutel van de leverancier. Laat je dit leeg, dan wordt alleen de endpointgetest; je kunt de sleutel dan niet valideren. Voor lokale leveranciers (Ollama / LM Studio) meestal niet nodig.
• Modellen — Twee opties, kies één:
  • Automatisch detecteren: klik op detecteer om de modellenlijst automatisch op te halen; selecteer meerdere via labels (chips).
  • Handmatig invoeren: voer modelnamen direct in. Voor Azure moet je hier de deployment name invullen in plaats van de modelnaam.
• Prioriteit / Gewicht — Wanneer meerdere kanalen hetzelfde model ondersteunen, bepaalt dit de routing en load balancing.

Azure OpenAI Let op

Voor Azure is het veld "Modellen" bedoeld voor de Deployment name die je zelf in het Azure portal hebt aangemaakt, niet de onderliggende modelnaam. De Base URL moet ook jouw specifieke Azure-resource endpoint zijn.

Stap 3: Bevestigen en verzenden

Controleer de samenvatting van de instellingen en dien in. Na succesvolle verzending verschijnt het nieuwe kanaal in de lijst, inclusief real-time gezondheidsstatus.

Connectiviteitstest

In de kanalenlijst kun je per kanaal een connectiviteitstest uitvoeren. Deze test bestaat uit twee onderdelen:

• Endpoint bereikbaarheid (reachable) — Controle of de Base URL toegankelijk is (netwerk- en adrescontrole).
• API Key geldigheid (authenticated) — Real-time test bij de leverancier om te controleren of de API Key werkt. Slechts beschikbaar indien een API Key is ingevuld.

Resultaten tonen round-trip latency (ms), statusbadge en foutmeldingen.

TIP

In de wizard: als het endpoint onbereikbaar is, kun je niet verder; is het endpoint bereikbaar maar is de API Key ongeldig, dan krijg je een waarschuwing en kun je desgewenst doorgaan (bijvoorbeeld als je van plan bent later een geldige sleutel toe te voegen).

Geavanceerde instellingen

Tijdens het toevoegen/bewerken van een kanaal kun je geavanceerde instellingen openen voor kostenbeheer en quotacontrole:

• Tarief-multiplier — Factor waarmee de officiële prijs wordt vermenigvuldigd, handig om eigen kosten of doorverkoopprijzen te hanteren. Standaard 1.0.
• Betaalstructuur — Beschrijft de prijsbepaling van het kanaal, zoals pay-as-you-go, abonnement, pakket.
• Saldo — Bronnen: vast bedrag, OSS-facturatie of handmatige invoer. Bij OSS kun je ook het type factuur kiezen. Saldo en laatste bijwerkdatum worden alleen-lezen weergegeven bij de kanaalgegevens.
• Abonnementsverloop — Voor abonnementen/pakketten kan de verloopdatum worden ingesteld.
• Quotabeperking (VIP) — Stel limieten in op aantal tokens, requests of bedrag, met keuze uit interval (dagelijks / wekelijks / maandelijks / aangepast). "Drift toegestaan" tolereert een kleine overschrijding van de limiet. Alleen beschikbaar bij betaalde features.

Kanalen bewerken en verwijderen

• Bewerken — In de kanalenlijst kun je naam, Base URL, API Key, modellen en geavanceerde instellingen aanpassen.
• Verwijderen — Verwijder je een kanaal dan kunnen gekoppelde virtuele sleutels niet meer via dat kanaal routeren. Wees voorzichtig met deze stap.

Gezondheidsstatus

De kanalenlijst en de overzichtspagina tonen de actuele status van alle kanalen (Normaal / Gedegradeerd / Niet beschikbaar), zodat je snel problemen met leveranciers kunt herkennen.

Veelgestelde vragen (FAQ)

• Vraag: Moet ik ingelogd zijn om kanalen toe te voegen?
  • Antwoord: De AI Gateway is een premiumfunctie van ServBay; je moet ingelogd zijn voor het toevoegen van kanalen en sleutels. Volg de aanmeldinstructies in het scherm.
• Vraag: Het maximum aantal kanalen is bereikt?
  • Antwoord: Het aantal kanalen hangt af van je pakket. Verwijder ongebruikte kanalen of upgrade je pakket om er meer toe te voegen.
• Vraag: De automatische modeldetectie werkt niet?
  • Antwoord: Controleer of de Base URL correct is en de API Key geldig (de connectiviteitstest biedt validatie). Sommige leveranciers sturen alleen een lijst bij een geldige API Key. Je kunt ook de modelnaam handmatig invoeren.
• Vraag: Moet ik een Key invullen voor lokale Ollama / LM Studio integratie?
  • Antwoord: Meestal niet. Zorg enkel dat de betreffende lokale service actief is en luistert op de standaardpoort (Ollama 11434, LM Studio 1234).

Samenvatting

Kanalen vormen de basis van AI Gateway request routing. Met de driefasenwizard sluit je snel bijna 20 leveranciers aan. Dual-regio wissels, automatische modeldetectie en dubbele connectiviteitstests garanderen een correcte setup. Geavanceerde functies als prijsbepaling en quotaregeling bieden fijnmazige kostenbeheersing. Zodra je kanalen zijn ingesteld, kun je virtuele sleutels aanmaken voor gebruik in apps en tools.