Routering en modelselectie: de relatie tussen kanalen, modellen en clients

Bij het gebruik van een AI-gateway zorgen drie concepten regelmatig voor verwarring: kanalen, modellen en clients. Als je begrijpt hoe ze samenhangen, kun je de routering correct configureren en voorkom je vragen zoals: "waarom is mijn request niet via het kanaal gegaan dat ik verwachtte?"

Drie basisconcepten

• Een kanaal is één upstream-verbinding: een Ollama-instantie of een account bij een cloudprovider.
• Een model is een mogelijkheid die een kanaal biedt: bijvoorbeeld een concrete modelnaam zoals qwen3:8b.
• Een client is de AI-tool die je dagelijks gebruikt: Claude Code, Codex, opencode, enzovoort.

Hun onderlinge relatie vormt een eenrichtingsketen:

Client → (virtuele sleutel) → Gateway (routeringsstrategie) → Kanaal → Model

Bij elk request geeft de client de modelnaam op; de gateway zoekt aan de hand van die modelnaam een kanaal dat het model kan leveren en stuurt het request daarheen door.

Wat betekent "model (kanaalnaam)" in de modellenlijst?

In de modelkiezer van clients als Claude Code en opencode zie je vermeldingen zoals qwen3:8b (Ollama Qwen3). De naam tussen haakjes geeft het bronkanaal van dat model aan — het is geen "extra verbinding":

• Tussen jouw client en de gateway bestaat altijd maar één verbinding (één adres + één virtuele sleutel).
• Hetzelfde model kan op meerdere kanalen geconfigureerd zijn. In dat geval toont de modelkiezer alsnog slechts één regel (tussen haakjes staat dan één van de bronkanalen). Welk kanaal een request feitelijk afhandelt, bepaalt de routeringsstrategie (zie hieronder).

Drie routeringsmodi: Fixed, Failover en Balanced

De routeringsstrategie beantwoordt één vraag: als meerdere kanalen hetzelfde model kunnen leveren, welk kanaal wordt er dan gebruikt?

Modus	Gedrag	Geschikt voor
Fixed (vast)	Gebruikt altijd hetzelfde kanaal	Stabiele kanaalkwaliteit, wanneer je de bron wilt vastleggen
Failover (primair/back-up)	Als het primaire kanaal uitvalt of zonder quota zit, wordt er op volgorde overgeschakeld naar een back-upkanaal	Configuraties met een primair en een back-upkanaal
Balanced (gebalanceerd)	Verdeelt requests om en om over de beschikbare kanalen	Meerdere gelijkwaardige kanalen om de belasting te verdelen

Twee belangrijke kanttekeningen:

1. Routering schakelt alleen tussen kanalen, nooit tussen modellen. Welk model wordt aangevraagd, bepaalt altijd jouw client; de gateway wisselt het model niet voor je om.
2. Verschillende modellen gaan van nature al via hun eigen kanalen. Balanced betekent niet "nu het model van kanaal A, straks dat van kanaal B" — het wisselt alleen af tussen de kanalen van hetzelfde model.

Het model wordt bepaald door de client: zo wissel je van model

De gateway stuurt alleen door: jouw tool voegt bij elk request de modelnaam toe en de gateway routeert op basis daarvan. Het wisselen van model gebeurt dus in de client:

• opencode: kies via /models in de TUI; of configureer model (hoofdmodel) en small_model (lichte taken zoals titelgeneratie) in opencode.json.
• Claude Code: wissel met het commando /model.
• Codex: geef het model op met de parameter -m <model> of via een configuratiebestand.

Sluit je dagelijkse tools veilig aan op de gateway

Ben je bang dat dit je dagelijkse gebruik verstoort? Volg dan deze stappen:

1. Test eerst met een onbelangrijk project: voer in de map van een minder belangrijk project de aansluiting met één klik uit en controleer of je workflow naar behoren werkt.
2. Verifieer met één request: stuur een testrequest en bekijk op de pagina "Gebruiksgeschiedenis" op welk model en welk kanaal het terechtkwam en wat het heeft gekost.
3. Je kunt altijd terugdraaien: stop de overname op de pagina "Aansluitbeheer". Na het stoppen worden de door ServBay geschreven configuraties verwijderd en worden de bij de overname aangemaakte virtuele sleutels ingetrokken; je eerdere eigen configuraties worden niet automatisch hersteld — pas ze zo nodig handmatig aan; na het herstarten van de client is de wijziging van kracht.

Samenvatting

• Kanaal = upstream-verbinding; model = mogelijkheid op een kanaal; de modelnaam wordt door de client bij elk request opgegeven.
• De routeringsstrategie kiest uitsluitend tussen "meerdere kanalen voor hetzelfde model": Fixed = vast, Failover = primair/back-up, Balanced = om-en-om.
• Wissel van model via de modelkiezer van de client; controleer op de pagina "Gebruiksgeschiedenis" de herkomst en kosten van elk request.

Gerelateerde artikelen

• Introductie van de AI-gateway
• Kanaalbeheer
• Virtuele sleutels
• Overname met één klik