AI Gateway-endpoints en omgevingsvariabelen

Naast het overnemen met één klik van bestaande AI-tools, kun je de AI Gateway ook direct aanroepen binnen je eigen applicaties, scripts of andere AI-tools. In dit artikel lees je welk endpointformaat de gateway aanbiedt en hoe je toegang krijgt via een virtuele sleutel.

Proxy-endpoint

De proxyservice van de AI Gateway luistert op http://127.0.0.1:11580. Om compatibiliteit te bieden met verschillende SDK’s en tools, biedt de gateway verschillende protocolformaten op dezelfde poort aan:

Protocolformaat	Endpointpad	Geschikt voor
OpenAI compatibel	http://127.0.0.1:11580/v1	SDK’s/tools die het OpenAI API-formaat gebruiken (zoals /v1/chat/completions)
Anthropic compatibel	http://127.0.0.1:11580/v1/messages	Anthropic SDK en bijvoorbeeld Claude Code
Gemini compatibel	http://127.0.0.1:11580/v1beta	Google Gemini SDK, Gemini CLI, enzovoorts

Kies gewoon het juiste protocolformaat dat past bij je SDK, en stuur je verzoeken naar het gatewayadres. De gateway routeert deze aanvragen, op basis van de machtigingen van je virtuele sleutel, naar het juiste kanaal van de aanbieder.

Authenticatie: virtuele sleutel gebruiken

Alle aanvragen aan de gateway worden geauthenticeerd met een virtuele sleutel, niet met een echte sleutel van de leverancier. Maak eerst een virtuele sleutel aan op de pagina Virtuele sleutels en kopieer de weergegeven tekst.

Op de pagina AI Gateway → Endpoints kun je een virtuele sleutel kiezen; de gateway genereert dan direct bruikbare fragmenten van omgevingsvariabelen voor veelgebruikte tools.

Voorbeeld van omgevingsvariabelen

In de voorbeelden hieronder ga je ervan uit dat je een virtuele sleutel hebt verkregen (aangeduid als <jouw virtuele sleutel>).

OpenAI-compatibele SDK’s/tools

export OPENAI_BASE_URL="http://127.0.0.1:11580/v1"
export OPENAI_API_KEY="<jouw virtuele sleutel>"

Claude Code / Anthropic

# Let op: het Anthropic-protocol gebruikt de root van het gatewayadres, dus zonder /v1
export ANTHROPIC_BASE_URL="http://127.0.0.1:11580"
export ANTHROPIC_AUTH_TOKEN="<jouw virtuele sleutel>"

Gemini

export GOOGLE_GEMINI_BASE_URL="http://127.0.0.1:11580"
export GEMINI_API_KEY="<jouw virtuele sleutel>"

Voorbeeld van een verzoek (OpenAI-compatibel)

curl http://127.0.0.1:11580/v1/chat/completions \
  -H "Authorization: Bearer <jouw virtuele sleutel>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hallo"}]
  }'

Hierbij moet de model-waarde overeenkomen met een model dat jij hebt geconfigureerd bij Kanalen en waarvoor jouw virtuele sleutel toestemming heeft.

Vereisten

• De proxyservice van de AI Gateway draait en is bereikbaar.
• Er is minimaal één gezond kanaal geconfigureerd én er bestaat een virtuele sleutel met de juiste rechten voor een model/kanaal.

Veelgestelde vragen (FAQ)

• Q: Geeft het verzoek een authenticatiefout?
  • A: Controleer of je een virtuele sleutel gebruikt (niet de echte sleutel van de aanbieder), en zorg dat de sleutel niet is verlopen of ingetrokken.
• Q: Krijg je melding “Model niet beschikbaar” of “Onvoldoende rechten”?
  • A: Controleer of het model is toegevoegd bij een kanaal, en of jouw virtuele sleutel gemachtigd is voor dit model/kanaal.
• Q: Welk endpointformaat moet ik gebruiken?
  • A: Kies het formaat dat past bij je SDK: OpenAI-stijl gebruikt /v1, Anthropic-stijl /v1/messages (maar let op: de base URL dus zonder /v1), Gemini-stijl /v1beta.
• Q: Kan ik de gateway in mijn lokale netwerk vanaf andere apparaten bereiken?
  • A: De gateway luistert standaard uitsluitend op 127.0.0.1 (alleen lokaal). Dit is een aanbevolen instelling omwille van de veiligheid.

Samenvatting

De AI Gateway biedt één lokale endpoint aan – compatibel met OpenAI, Anthropic en Gemini – en werkt met virtuele sleutels voor authenticatie. Daardoor kun je eenvoudig elke applicatie of AI-tool koppelen aan de gateway en profiteren van gecentraliseerd sleutelbeheer en verbruiksstatistieken. Voor gangbare CLI-tools gaat overnemen met één klik nog sneller.