Kľúče a adresa API
MarkdownKde získať kľúč, akú adresu nastaviť v jednotlivých SDK a ako kľúč odovzdávať.
Úplný sprievodca
API kľúč
Kľúč sa vytvára v účte na ailoot.ai po registrácii. Vyzerá ako sk-…. Môžete vytvoriť viac kľúčov: samostatne pre pracovný počítač, server a každú aplikáciu – jeden tak ľahšie zneplatníte bez zásahu do ostatných.
Pri kľúči možno nastaviť celkový limit výdavkov, platnosť, zoznamy povolených a zakázaných IP adries a limity výdavkov za okná 5 hodín, 1 deň a 7 dní. Pri uplatnení obmedzenia príde zrozumiteľná chyba: api_key_quota_exhausted (celkový limit je vyčerpaný), usage_limit_reached (limit výdavkov kľúča za časové okno je vyčerpaný – počkajte na obnovenie okna alebo zvýšte limit), api_key_expired alebo permission_denied (napríklad požiadavka nepochádza z povolenej IP).
Adresa API
Hlavné pravidlo: pri klientoch kompatibilných s OpenAI je adresa s /v1, pri Anthropic a Gemini bez neho.
| Klient | Základná adresa | Kam smeruje požiadavka |
|---|---|---|
| OpenAI SDK a kompatibilné klienty | 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 |
| Klient vyžaduje úplnú adresu | https://api.ailoot.ai/v1/chat/completions | podľa zadania |
Ako odovzdať kľúč
Ailoot prijíma kľúč v ľubovoľnej z troch hlavičiek – vhodná je tá, ktorú odosiela váš SDK:
| Hlavička | Kto ju odosiela |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, väčšina klientov |
x-api-key: sk-… | Anthropic SDK, Claude Code s ANTHROPIC_API_KEY |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
Na cestách /v1/… sa kľúč v adrese (?key= alebo ?api_key=) neprijíma: požiadavka dostane 400 s kódom invalid_request a správou, že bol kľúč odovzdaný v adrese. Kľúč sa tak nedostane do logov ani histórie prehliadača. Ak už bol kľúč použitý v adrese, je lepšie vytvoriť nový.
Na cestách Gemini /v1beta/… sa kvôli kompatibilite s Google prijíma ?key= – s najnižšou prioritou, po hlavičkách. ?api_key= sa aj tam odmieta s chybou 400. Aj tak je spoľahlivejšie odovzdávať kľúč v hlavičke x-goog-api-key.
Premenné prostredia
Je praktické vytvoriť jednu premennú a dosádzať ju do nastavení rôznych programov:
# ~/.zshrc alebo ~/.bashrc
export AILOOT_API_KEY="sk-..."
# pre programy, ktoré čítajú štandardné názvy
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-..."
# pre programy, ktoré čítajú štandardné názvy
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-..."
# reštartujte terminál, aby sa premenné načítaliOverenie kľúča
Najlacnejší spôsob overenia kľúča je vyžiadať si zoznam modelov: je to bezplatné.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"