OpenAI, Anthropic, Gemini, Mistral, Groq of OpenRouter koppelen aan Xcellerate AIG

Door OpenAI, Anthropic, Google Gemini, Mistral, Groq of OpenRouter aan Xcellerate AIG te koppelen, krijgt je team één beheerde toegang tot gehoste AI-modellen. Je applicaties roepen AIG aan met hun eigen virtuele sleutel en krijgen de sleutel van de leverancier nooit te zien. Deze gids is voor de beheerder die AIG opzet voor een MSP, kmo of dienstverlener.

Kort samengevat

• De instelling is voor alle zes leveranciers dezelfde: kies het type, geef een naam, plak één API-sleutel.
• Een nieuwe provider start uitgeschakeld, zodat je hem eerst met één kleine aanvraag test.
• Na het inschakelen synchroniseer je de modelcatalogus en geef je per applicatie een virtuele sleutel uit.

Voor je begint

• Een account bij de leverancier en een gewone API-sleutel: een OpenAI-sleutel, een sleutel uit de Anthropic-console, een Google AI Studio-sleutel (Gemini API) of een sleutel van Mistral, Groq of OpenRouter.
• De rol Admin in AIG, of een eigen rol met het recht om providers aan te maken en te bewerken.
• Uitgaand HTTPS-verkeer van de AIG-server naar de leverancier. De standaardadressen zijn api.openai.com/v1, api.anthropic.com/v1, generativelanguage.googleapis.com/v1beta, api.mistral.ai/v1, api.groq.com/openai/v1, openrouter.ai/api/v1. Moet het verkeer via een proxy, dan stel je die in onder General settings → Network egress (algemene instellingen → uitgaand netwerkverkeer).
• Callback-URL's of webhooks zijn niet nodig.

De provider instellen

1. Start de wizard

Ga in de zijbalk naar Verbinden → Providers en klik op Een provider verbinden. Werk je liever met het volledige formulier, kies dan Handmatig instellen of Provider toevoegen.

2. Kies de leverancier en geef een naam

Kies bij Providertype voor OpenAI, Anthropic, Google Gemini, Mistral, Groq of OpenRouter. Geef een Weergavenaam die iedereen herkent, bijvoorbeeld "OpenAI productie". Laat Basis-URL leeg om het standaardadres van de leverancier te gebruiken.

3. Plak de API-sleutel

Plak de sleutel in het veld API-sleutel. AIG bewaart de provider uitgeschakeld, dus er gaat nog geen verkeer naartoe.

4. Test de verbinding

Stuur met Try it (probeer het) één kleine, echte aanvraag. Dat kost een paar tokens. Je kunt ook voor Continue anyway (toch doorgaan) kiezen; de provider blijft dan uitgeschakeld. Later doe je dezelfde controle met Verbinding testen.

5. Inschakelen, synchroniseren en een sleutel uitgeven

Klik op Enable provider (provider inschakelen). Laad daarna de modelcatalogus via Models → Sync (modellen → synchroniseren) en maak een sleutel voor je applicatie aan via Governance → Virtual keys → New virtual key (nieuwe virtuele sleutel).

Optioneel: meer sleutels, smallere scope

• Met Sleutel toevoegen zet je meerdere sleutels van de leverancier op één provider. Geef elke sleutel een Weight (gewicht) om het verkeer te spreiden.
• Beperk een sleutel tot bepaalde modellen met Allowed models (toegestane modellen).
• Vink onder Wat deze provider levert alleen aan wat je nodig hebt.

Wat er gebeurt na het koppelen

Je applicaties spreken een model aan als <provider-naam>/<model>, bijvoorbeeld openai/gpt-4o-mini, of met een kale modelnaam die AIG via de catalogus opzoekt. AIG vertaalt elke aanvraag naar het formaat van de leverancier. Zo kan één aanvraag in OpenAI-stijl bij OpenAI, Anthropic of Gemini terechtkomen.

De catalogussynchronisatie haalt modelnamen, contextvensters en prijzen op uit een gepubliceerd gegevensblad, volgens een schema (hoogstens één keer per uur) of op aanvraag. Heb je onderhandelde prijzen, dan kun je die overschrijven.

Wat elk type levert:

• OpenAI: chat, embeddings, afbeeldingen, spraak, transcriptie, rerank
• Anthropic: chat
• Google Gemini: chat, embeddings
• Mistral: chat, embeddings, transcriptie
• Groq: chat, transcriptie, spraak
• OpenRouter: chat, embeddings, afbeeldingen

Goed om te weten

• Max retries (maximaal aantal nieuwe pogingen) staat standaard op 0. Zet nieuwe pogingen bewust aan.
• Met meerdere sleutels wisselt AIG automatisch af. Een geweigerde sleutel krijgt de status Dead of Suspect; een sleutel die tegen een limiet loopt, staat op Cooling down en komt vanzelf terug.
• Een provider uitschakelen stopt het verkeer vanaf de volgende aanvraag; de sleutels blijven bewaard. Een provider verwijderen, verwijdert ook zijn sleutels.
• Gestreamde aanvragen in OpenAI-stijl krijgen alleen een prijs als de aanroeper stream_options: {"include_usage": true} meestuurt.
• API-sleutels zijn alleen-schrijven: na het opslaan zie je enkel een gemaskeerde hint zoals sk-…4f2a, en sleutels van de leverancier verschijnen nooit in foutmeldingen.
• Zonder licentie draait AIG in de gratis modus: 5 virtuele sleutels met elk 5 aanvragen per dag. Een licentie heft die grens op.

Problemen oplossen

• "No enabled key to test with." Voeg een sleutel toe of schakel de bestaande in, en test opnieuw.
• "No model to try. Sync the catalog first…" Voer Models → Sync uit en probeer opnieuw.
• <model> did not answer (<ms> ms): <message> De melding komt van de leverancier. Controleer de sleutel en of je account toegang heeft tot dat model.
• No healthy API key is available for provider '…' (503) of Every API key configured for '…' failed for this request. (502): bekijk de status van de sleutels (Healthy, Dead, Cooling down, Suspect), herstel de sleutel en klik op Clear health flags (statusmarkeringen wissen). No enabled provider is configured for '…' (400) betekent dat er voor die naam geen ingeschakelde provider is.

Praat met ons over AIG

Wil je zien hoe AIG past bij je MSP of dienstverlenend bedrijf? Praat met ons over AIG. Lees ook meer over alle providers in één catalogus en virtuele sleutels.