Source: https://ailoot.ai/docs/cs/keys/
Canonical: https://ailoot.ai/docs/cs/keys/
Language: cs

[Úvod](https://ailoot.ai/docs/cs/) 

# Klíče a adresa API

[Markdown](https://ailoot.ai/docs/cs/keys/index.md)

Kde získat klíč, jakou adresu uvést v jednotlivých SDK a jak klíč předávat.

## [](https://ailoot.ai/docs/cs/keys/#key)Klíč API

Klíč vytvoříte v uživatelském panelu na [ailoot.ai](https://ailoot.ai) po [registraci](https://ailoot.ai/register). 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).

Klíč nezveřejňujte v kódu, repozitářích ani na snímcích obrazovky. Ukládejte jej do proměnné prostředí nebo správce tajných údajů. Pokud klíč unikne, smažte jej v uživatelském panelu a vytvořte nový.

## [](https://ailoot.ai/docs/cs/keys/#base-url)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í |

Dostali jste 404 hned po nastavení? Téměř vždy je příčinou adresa: nadbytečné nebo chybějící `/v1`, dvojité lomítko nebo `/chat/completions` tam, kde jej klient doplňuje sám.

## [](https://ailoot.ai/docs/cs/keys/#auth)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`.

## [](https://ailoot.ai/docs/cs/keys/#env)Proměnné prostředí

Je praktické vytvořit jednu proměnnou a použít ji v nastavení různých programů:

```bash
# ~/.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"
```

```powershell
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četly
```

## [](https://ailoot.ai/docs/cs/keys/#check)Ověření klíče

Nejlevnější způsob ověření klíče je vyžádat si seznam modelů: je to zdarma.

```bash
curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"
```

Máte další dotazy? Pošlete Request ID a popis – pomůžeme situaci objasnit.[Napsat podpoře](mailto:support@ailoot.ai)

## Ailoot · Společnost a její portfolio projektů





Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI.





Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.





Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.