Je apps en tools koppelen aan Xcellerate AIG: OpenAI-compatibele API, Claude Code, Cursor en Copilot Studio

Elke app, SDK of tool die met OpenAI praat, kan met Xcellerate AIG praten zodra je twee instellingen aanpast: de base URL en de API-sleutel. Teams die de SDK's van Anthropic, Google of AWS Bedrock gebruiken, kunnen die houden, want AIG antwoordt in het formaat van elke leverancier. Elke aanroep krijgt dan budgetten, rate limits, guardrails, routing, failover en een logregel.

TL;DR

• Maak één virtuele sleutel per app, team of agent.
• Wijs de client naar de juiste base URL: /v1, /anthropic, /genai, /bedrock of /v1/mcp.
• Controleer de eerste aanroep in de logboeken. De echte sleutels van je providers komen nooit bij je clients terecht.

Voordat je begint

• Een beheerder die virtuele sleutels mag aanmaken (recht Governance).
• Minstens één ingeschakelde provider in AIG en een gesynchroniseerde modelcatalogus.
• Netwerktoegang van de app naar https://<your-gateway> (TLS, poort 443).
• Een client waarin je een eigen base URL of endpoint kunt instellen.

Je app of tool koppelen

1. Maak een virtuele sleutel

Ga naar Besturen → Governance → Virtuele sleutels en klik op Nieuwe virtuele sleutel. Beperk eventueel providers en modellen, en stel een budget, rate limit, vervaldatum (van 30 minuten tot nooit), MCP-tools en IP-beleid in. Kopieer het sk-xc-…-token meteen: het wordt maar één keer getoond.

2. Wijs de client naar AIG

• Claude Code: zet ANTHROPIC_BASE_URL op https://<your-gateway>/anthropic en ANTHROPIC_AUTH_TOKEN op je virtuele sleutel.
• Microsoft Copilot Studio: endpoint https://<your-gateway>/v1/mcp, authenticatie "API key", header Authorization: Bearer <virtual key>. Tools verschijnen als mcp__<server>__<tool>.

3. Gebruik een modelnaam uit AIG

Neem de modelnaam uit Connect → Models (Verbinden → Modellen), bijvoorbeeld openai/gpt-4o-mini, of de korte naam als die uniek is.

4. Controleer de eerste aanroep

Stuur een verzoek en open Verkeer → Logboeken. De filter "Arrived as" toont langs welke ingang de aanroep binnenkwam. Elk antwoord bevat het request-ID in de header x-xc-request-id.

Wat gebeurt er na het koppelen

• GET /v1/models toont alleen de modellen die die sleutel mag gebruiken.
• /v1 dekt chat completions (ook streaming), embeddings, beeldgeneratie, spraak, transcriptie, rerank, models, responses, files, batches, feedback en MCP.
• Routing kan een verzoek door een andere provider laten afhandelen dan de client vroeg; het antwoord blijft in het formaat van de aanroeper.
• Optionele headers: x-xc-tags (bv. prod,checkout) voor kostentoewijzing, x-xc-agent-name en x-xc-agent-run-id voor tijdlijnen van agents, X-Request-Id en traceparent om je eigen logs en traces te koppelen.

Goed om te weten

• Gestreamde verzoeken hebben stream_options: {"include_usage": true} nodig om geprijsd te worden.
• Bedrock-SDK-clients moeten de SigV4-header Authorization vervangen door de virtuele sleutel, bijvoorbeeld met een boto3-event hook. Alleen invoke en invoke-with-response-stream worden bediend.
• Functieaanroepen van Gemini komen in één keer, niet gestreamd. Anthropic-streams melden de inputtokens pas op het einde.
• Bèta-endpoints van providers zijn niet gemodelleerd. Er bestaat een pass-through per sleutel en per provider, maar die staat standaard uit.
• In de gratis modus: maximaal 5 actieve virtuele sleutels en 5 verzoeken per sleutel per dag.
• Chatinterfaces zoals Open WebUI hebben geen aparte integratie. Koppel ze zoals elke OpenAI-compatibele client.

Probleemoplossing

• 401 "Incorrect API key provided." of "This API key has expired.": de sleutel is onbekend, ingetrokken of verlopen.
• 403 "This API key is not permitted to use the model '…'.": het model valt buiten de scope van de sleutel. Ook een guardrail-blokkering geeft 403.
• 404 "The model '…' does not exist or you do not have access to it.": controleer de naam in het scherm Models.
• 402 of 429: budget of rate limit van de sleutel is op; wacht de retry-after-tijd af.

Fouten op /anthropic en /genai komen terug in het foutformaat van die leverancier.

Lees meer over één API voor elk model, virtuele sleutels en request logs.

Wil je de AI-tools van je team via één beheerde gateway laten lopen? Praat met ons over AIG.