Raktai ir API adresas
MarkdownKur gauti raktą, kokį adresą nurodyti skirtinguose SDK ir kaip perduoti raktą.
Visas vadovas
API raktas
Raktas sukuriamas paskyroje svetainėje ailoot.ai po registracijos. Jis atrodo taip: sk-…. Galima sukurti kelis raktus: atskirai darbo kompiuteriui, serveriui ir kiekvienai programai — taip lengviau atšaukti vieną nepaveikiant kitų.
Raktui galima nustatyti bendrą išlaidų limitą, galiojimo laiką, leidžiamų ir draudžiamų IP adresų sąrašus bei išlaidų limitus per 5 valandų, 1 dienos ir 7 dienų langus. Suveikus apribojimui gausite aiškią klaidą: api_key_quota_exhausted (išnaudotas bendras limitas), usage_limit_reached (išnaudotas rakto išlaidų langas — palaukite, kol jis atsinaujins, arba padidinkite limitą), api_key_expired arba permission_denied (pavyzdžiui, užklausa ne iš leidžiamo IP).
API adresas
Pagrindinė taisyklė: su OpenAI suderinamiems klientams adresas su /v1, Anthropic ir Gemini — be jo.
| Klientas | Bazinis adresas | Kur siunčiama užklausa |
|---|---|---|
| OpenAI SDK ir suderinami klientai | 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 |
| Klientas prašo viso adreso | https://api.ailoot.ai/v1/chat/completions | kaip nurodyta |
Kaip perduoti raktą
Ailoot priima raktą bet kurioje iš trijų antraščių — tiks ta, kurią siunčia jūsų SDK:
| Antraštė | Kas taip siunčia |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, dauguma klientų |
x-api-key: sk-… | Anthropic SDK, Claude Code su ANTHROPIC_API_KEY |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
Keliuose /v1/… raktas adrese (?key= arba ?api_key=) nepriimamas: užklausa gaus 400 su kodu invalid_request ir pranešimu, kad raktas perduotas adrese. Taip raktas nepatenka į žurnalus ir naršyklės istoriją. Jei raktas jau buvo adrese, geriau sukurti naują.
Gemini keliuose /v1beta/… suderinamumui su Google priimamas ?key= — su mažiausiu prioritetu, po antraščių. ?api_key= ten taip pat atmetamas grąžinant 400. Vis tiek patikimiau raktą perduoti antraštėje x-goog-api-key.
Aplinkos kintamieji
Patogu sukurti vieną kintamąjį ir jį naudoti skirtingų programų nustatymuose:
# ~/.zshrc arba ~/.bashrc
export AILOOT_API_KEY="sk-..."
# programoms, kurios skaito standartinius pavadinimus
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-..."
# programoms, kurios skaito standartinius pavadinimus
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-..."
# paleiskite terminalą iš naujo, kad kintamieji būtų pritaikytiRakto patikra
Pigiausias būdas patikrinti raktą — paprašyti modelių sąrašo: tai nemokama.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"