Sleutels en API-adres
MarkdownWaar je de sleutel vindt, welk adres je per SDK opgeeft en hoe je de sleutel meegeeft.
Volledige gids
API-sleutel
Je maakt de sleutel aan in het dashboard op ailoot.ai na registratie. Deze ziet eruit als sk-…. Je kunt meerdere sleutels aanmaken: apart voor werkcomputer, server en elke app. Zo kun je er één intrekken zonder de andere te wijzigen.
Je kunt een totale bestedingslimiet, vervaldatum, lijsten met toegestane en geblokkeerde IP-adressen en bestedingslimieten voor tijdvensters van 5 uur, 1 dag en 7 dagen instellen. Als een beperking een verzoek blokkeert, krijg je een duidelijke fout: api_key_quota_exhausted (totale limiet opgebruikt), usage_limit_reached (bestedingsvenster opgebruikt — wacht totdat het vernieuwd is of verhoog de limiet), api_key_expired of permission_denied (bijvoorbeeld een verzoek vanaf een niet-toegestaan IP-adres).
API-adres
Hoofdregel: bij OpenAI-compatibele clients bevat het adres /v1, bij Anthropic en Gemini niet.
| Client | Basisadres | Waar het verzoek naartoe gaat |
|---|---|---|
| OpenAI SDK en compatibele clients | https://api.ailoot.ai/v1 | /v1/chat/completions, /v1/responses, /v1/embeddings |
| Anthropic SDK, Claude Code | https://api.ailoot.ai | /v1/messages |
| Google GenAI SDK, Gemini CLI | https://api.ailoot.ai | /v1beta/models/{model}:generateContent |
| De client vraagt om het volledige adres | https://api.ailoot.ai/v1/chat/completions | zoals aangegeven |
Hoe je de sleutel meegeeft
Ailoot accepteert de sleutel in elk van de drie headers — de header van jouw SDK is dus geschikt:
| Header | Wie deze meestuurt |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, de meeste clients |
x-api-key: sk-… | Anthropic SDK, Claude Code met ANTHROPIC_API_KEY |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
Op de paden /v1/… wordt een sleutel in het adres (?key= of ?api_key=) niet geaccepteerd: het verzoek krijgt 400 met code invalid_request en een melding dat de sleutel in het adres is meegegeven. Zo komt de sleutel niet in logs en browsergeschiedenis terecht. Als de sleutel al in een adres heeft gestaan, maak dan bij voorkeur een nieuwe aan.
Op Gemini-paden /v1beta/… wordt voor compatibiliteit met Google ?key= geaccepteerd — met de laagste prioriteit, na de headers. ?api_key= wordt ook daar afgewezen met 400. Betrouwbaarder is het meegeven van de sleutel in de header x-goog-api-key.
Omgevingsvariabelen
Je kunt eenvoudig één variabele instellen en die in verschillende programma’s gebruiken:
# ~/.zshrc of ~/.bashrc
export AILOOT_API_KEY="sk-..."
# voor programma's die de standaardnamen lezen
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"setx AILOOT_API_KEY "sk-..."
# voor programma's die de standaardnamen lezen
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# start de terminal opnieuw zodat de variabelen worden geladenDe sleutel controleren
De goedkoopste manier om de sleutel te controleren is de modellenlijst opvragen: dat is gratis.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"