Nøgler og API-adresse
MarkdownHvor du får en nøgle, hvilken adresse du skal angive i forskellige SDK'er, og hvordan du sender nøglen.
Komplet guide
API-nøgle
Nøglen oprettes i kontrolpanelet på ailoot.ai efter oprettelse af konto. Den ser sådan ud: sk-…. Du kan oprette flere nøgler: separate nøgler til arbejdscomputeren, serveren og hver applikation — så er det lettere at tilbagekalde én uden at påvirke resten.
For en nøgle kan du angive en samlet forbrugsgrænse, gyldighedsperiode, lister over tilladte og blokerede IP-adresser samt forbrugsgrænser for vinduer på 5 timer, 1 dag og 7 dage. Hvis en begrænsning aktiveres, får du en forståelig fejl: api_key_quota_exhausted (samlet grænse nået), usage_limit_reached (nøglens forbrugsvindue er opbrugt — vent, indtil vinduet fornyes, eller hæv grænsen), api_key_expired eller permission_denied (for eksempel anmodning fra en IP-adresse, der ikke er tilladt).
API-adresse
Hovedregel: For OpenAI-kompatible klienter bruges adresse med /v1, for Anthropic og Gemini — uden.
| Klient | Basisadresse | Hvor anmodningen sendes |
|---|---|---|
| OpenAI SDK og kompatible klienter | 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 |
| Klienten kræver den fulde adresse | https://api.ailoot.ai/v1/chat/completions | som angivet |
Sådan sender du nøglen
Ailoot accepterer nøglen i enhver af de tre headere — den, dit SDK sender, kan bruges:
| Header | Hvem sender den sådan? |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, de fleste klienter |
x-api-key: sk-… | Anthropic SDK, Claude Code med ANTHROPIC_API_KEY |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
På stierne /v1/… accepteres nøglen i adressen (?key= eller ?api_key=) ikke: anmodningen får 400 med koden invalid_request og en besked om, at nøglen blev sendt i adressen. Det forhindrer nøglen i at komme i logs og browserhistorik. Hvis nøglen allerede har været i adressen, er det bedst at oprette en ny.
På Gemini-stier /v1beta/… accepteres af hensyn til Google-kompatibilitet ?key= — med laveste prioritet, efter headerne. ?api_key= afvises også dér med 400. Det er stadig mere sikkert at sende nøglen i headeren x-goog-api-key.
Miljøvariabler
Det er praktisk at oprette én variabel og bruge den i forskellige programmers indstillinger:
# ~/.zshrc eller ~/.bashrc
export AILOOT_API_KEY="sk-..."
# til programmer, der læser standardnavnene
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-..."
# til programmer, der læser standardnavnene
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-..."
# genstart terminalen, så variablerne bliver indlæstKontrol af nøglen
Den billigste måde at kontrollere nøglen på er at hente modellisten: det er gratis.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"