Nycklar och API-adress
MarkdownVar du får nyckeln, vilken adress du anger i olika SDK:er och hur nyckeln skickas.
Fullständig guide
API-nyckel
Nyckeln skapas i kontrollpanelen på ailoot.ai efter registrering. Den ser ut som sk-…. Du kan skapa flera nycklar: en för arbetsdatorn, en för servern och en för varje app — då är det enklare att återkalla en utan att påverka de andra.
En nyckel kan ha total utgiftsgräns, giltighetstid, listor med tillåtna och blockerade IP-adresser samt utgiftsgränser för fönster på 5 timmar, 1 dag och 7 dagar. När en begränsning nås får du ett begripligt fel: api_key_quota_exhausted (totalgränsen är förbrukad), usage_limit_reached (nyckelns förbrukningsfönster är förbrukat — vänta tills det förnyas eller höj gränsen), api_key_expired eller permission_denied (till exempel ett anrop från en IP-adress som inte är tillåten).
API-adress
Huvudregeln: OpenAI-kompatibla klienter använder adress med /v1, Anthropic och Gemini använder adress utan.
| Klient | Basadress | Vart anropet skickas |
|---|---|---|
| OpenAI SDK och kompatibla 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 fullständig adress | https://api.ailoot.ai/v1/chat/completions | som angivet |
Så skickar du nyckeln
Ailoot godtar nyckeln i någon av de tre headerna — den som ditt SDK använder fungerar:
| Header | Vilka som använder den |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, de flesta klienter |
x-api-key: sk-… | Anthropic SDK, Claude Code med ANTHROPIC_API_KEY |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
På sökvägarna /v1/… godtas nyckeln i adressen (?key= eller ?api_key=) inte: anropet får 400 med koden invalid_request och en förklaring att nyckeln skickades i adressen. Då hamnar nyckeln inte i loggar eller webbläsarhistorik. Om nyckeln redan har använts i adressen bör du skapa en ny.
På Geminis sökvägar /v1beta/… godtas för kompatibilitet med Google ?key= — med lägst prioritet, efter headerna. ?api_key= avvisas även där med 400. Det är ändå säkrare att skicka nyckeln i headern x-goog-api-key.
Miljövariabler
Det är praktiskt att skapa en variabel och använda den i flera programs inställningar:
# ~/.zshrc eller ~/.bashrc
export AILOOT_API_KEY="sk-..."
# för program som läser standardnamnen
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-..."
# för program som läser standardnamnen
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-..."
# starta om terminalen så att miljövariablerna läses inKontroll av nyckeln
Det billigaste sättet att kontrollera nyckeln är att hämta modellistan: det är gratis.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"