Ključi in naslov API-ja
MarkdownKje pridobite ključ, kateri naslov navedete pri različnih SDK-jih in kako pošljete ključ.
Celoten vodnik
Ključ API
Ključ ustvarite na nadzorni plošči na ailoot.ai po registraciji. Videti je kot sk-…. Ustvarite lahko več ključev: ločeno za delovni računalnik, strežnik in vsako aplikacijo – tako enega lažje prekličete, ne da bi vplivali na druge.
Pri ključu lahko nastavite skupno omejitev porabe, veljavnost, seznam dovoljenih in blokiranih naslovov IP ter omejitve porabe v časovnih oknih 5 ur, 1 dan in 7 dni. Če se omejitev sproži, prejmete razumljivo napako: api_key_quota_exhausted (skupna omejitev je izčrpana), usage_limit_reached (časovno okno porabe ključa je izčrpano – počakajte, da se okno obnovi, ali zvišajte omejitev), api_key_expired ali permission_denied (na primer, zahteva ni z dovoljenega IP).
Naslov API-ja
Glavno pravilo: pri odjemalcih, združljivih z OpenAI, mora naslov vsebovati /v1, pri Anthropic in Gemini pa ne.
| Odjemalec | Osnovni naslov | Kam se pošlje zahteva |
|---|---|---|
| OpenAI SDK in združljivi odjemalci | 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 |
| Odjemalec zahteva celotni naslov | https://api.ailoot.ai/v1/chat/completions | kot je naveden |
Kako poslati ključ
Ailoot sprejema ključ v katerikoli od treh glav – ustreza tista, ki jo pošlje vaš SDK:
| Glava | Kdo pošilja na ta način |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, večina odjemalcev |
x-api-key: sk-… | Anthropic SDK, Claude Code z ANTHROPIC_API_KEY |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
Pri poteh /v1/… ključ v naslovu (?key= ali ?api_key=) ni sprejet: zahteva prejme 400 s kodo invalid_request in sporočilom, da je ključ poslan v naslovu. Tako ključ ne zaide v dnevnike in zgodovino brskalnika. Če je bil ključ že v naslovu, je bolje ustvariti novega.
Pri poteh Gemini /v1beta/… zaradi združljivosti z Google je sprejet ?key= – z najnižjo prednostjo, za glavami. ?api_key= je tudi tam zavrnjen s 400. Še vedno je zanesljiveje ključ poslati v glavi x-goog-api-key.
Okoljske spremenljivke
Priročno je ustvariti eno spremenljivko in jo uporabiti v nastavitvah različnih programov:
# ~/.zshrc ali ~/.bashrc
export AILOOT_API_KEY="sk-..."
# za programe, ki berejo standardna imena
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-..."
# za programe, ki berejo standardna imena
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-..."
# znova zaženite terminal, da se spremenljivke uveljavijoPreverjanje ključa
Najcenejši način preverjanja ključa je zahteva za seznam modelov: to je brezplačno.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"