Klíče a adresa API
MarkdownKde získat klíč, jakou adresu uvést v jednotlivých SDK a jak klíč předávat.
Úplný průvodce
Klíč API
Klíč vytvoříte v uživatelském panelu na ailoot.ai po registraci. Má podobu sk-…. Můžete vytvořit několik klíčů: zvlášť pro pracovní počítač, server a každou aplikaci – snáze tak odvoláte jeden z nich, aniž byste zasáhli ostatní.
U klíče lze nastavit celkový limit výdajů, platnost, seznam povolených a zakázaných IP adres a limity výdajů pro časová okna 5 hodin, 1 den a 7 dní. Při dosažení omezení obdržíte srozumitelnou chybu: api_key_quota_exhausted (vyčerpán celkový limit), usage_limit_reached (vyčerpán limit výdajů klíče pro dané časové okno – počkejte, než se okno obnoví, nebo limit zvyšte), api_key_expired nebo permission_denied (například požadavek z nepovolené IP adresy).
Adresa API
Základní pravidlo: pro klienty kompatibilní s OpenAI používejte adresu s /v1, pro Anthropic a Gemini – bez něj.
| Klient | Základní adresa | Kam se požadavek odesílá |
|---|---|---|
| OpenAI SDK a kompatibilní klienti | 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 úplnou adresu | https://api.ailoot.ai/v1/chat/completions | podle zadání |
Jak předat klíč
Ailoot přijímá klíč v kterékoli ze tří hlaviček – vyhoví tedy ta, kterou posílá vaše SDK:
| Hlavička | Kdo jej takto posílá |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, většina klientů |
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/… se klíč v adrese (?key= nebo ?api_key=) nepřijímá: požadavek obdrží 400 s kódem invalid_request a zprávou, že klíč byl předán v adrese. Klíč se tak nedostane do logů ani historie prohlížeče. Pokud se klíč už v adrese objevil, je lepší vytvořit nový.
Na cestách Gemini /v1beta/… se kvůli kompatibilitě s Google přijímá ?key= – s nejnižší prioritou, až po hlavičkách. ?api_key= se tam také odmítá s 400. Spolehlivější je přesto předávat klíč v hlavičce x-goog-api-key.
Proměnné prostředí
Je praktické vytvořit jednu proměnnou a použít ji v nastavení různých programů:
# ~/.zshrc nebo ~/.bashrc
export AILOOT_API_KEY="sk-..."
# pro programy, které čtou standardní 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-..."
# pro programy, které čtou standardní 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-..."
# restartujte terminál, aby se proměnné načetlyOvěření klíče
Nejlevnější způsob ověření klíče je vyžádat si seznam modelů: je to zdarma.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"