Nøkler og API-adresse
MarkdownHvor du får nøkkelen, hvilken adresse du bruker i ulike SDK-er, og hvordan nøkkelen sendes.
Fullstendig guide
API-nøkkel
Nøkkelen opprettes i kontrollpanelet på ailoot.ai etter registrering. Den ser slik ut: sk-…. Du kan opprette flere nøkler: én til arbeidsmaskinen, én til serveren og én til hver app — da kan én tilbakekalles uten å påvirke de øvrige.
En nøkkel kan ha samlet forbruksgrense, utløp, lister over tillatte og blokkerte IP-adresser og forbruksgrenser for vinduer på 5 timer, 1 dag og 7 dager. Hvis en begrensning utløses, får du en forståelig feil: api_key_quota_exhausted (samlet grense er nådd), usage_limit_reached (nøkkelens forbruksvindu er brukt opp — vent til vinduet fornyes, eller øk grensen), api_key_expired eller permission_denied (for eksempel en forespørsel fra en IP-adresse som ikke er tillatt).
API-adresse
Hovedregelen: OpenAI-kompatible klienter bruker adresse med /v1, Anthropic og Gemini bruker adresse uten.
| Klient | Basisadresse | Hvor forespørselen 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 ber om fullstendig adresse | https://api.ailoot.ai/v1/chat/completions | som angitt |
Slik sender du nøkkelen
Ailoot godtar nøkkelen i alle tre headerne — headeren SDK-et ditt sender, fungerer:
| Header | Hvem som bruker denne |
|---|---|
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å endepunktene /v1/… blir nøkkelen i adressen (?key= eller ?api_key=) ikke godtatt: forespørselen får 400 med koden invalid_request og en melding om at nøkkelen er angitt i adressen. Da havner ikke nøkkelen i logger og nettleserhistorikk. Hvis nøkkelen allerede har vært brukt i adressen, bør du opprette en ny.
På Gemini-endepunktene /v1beta/… godtas følgende for kompatibilitet med Google: ?key= — med lavest prioritet, etter headerne. ?api_key= avvises også her med 400. Det er fortsatt mer pålitelig å sende nøkkelen i headeren x-goog-api-key.
Miljøvariabler
Det er praktisk å opprette én variabel og bruke den i innstillingene til ulike programmer:
# ~/.zshrc eller ~/.bashrc
export AILOOT_API_KEY="sk-..."
# for programmer som leser 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-..."
# for programmer som leser 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-..."
# start terminalen på nytt for å laste inn variableneNøkkelkontroll
Den billigste måten å kontrollere nøkkelen på er å hente modellisten: det er gratis.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"