Source: https://ailoot.ai/docs/cs/how-it-works/
Canonical: https://ailoot.ai/docs/cs/how-it-works/
Language: cs

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

# Jak to funguje

[Markdown](https://ailoot.ai/docs/cs/how-it-works/index.md)

Co se děje s požadavkem mezi vaším programem a modelem.

Požadavek do Ailoot API odešlete stejně, jako byste jej odeslali přímo do OpenAI, Anthropic nebo Google. Ailoot ověří klíč a zůstatek, předá požadavek modelu, vrátí odpověď ve stejném formátu a odečte částku podle skutečné spotřeby.

<em>01</em><strong>Požadavek</strong>Váš klient odešle požadavek na api.ailoot.ai s klíčem sk-…

<em>02</em><strong>Kontrola a rezerva</strong>Klíč, limity, zůstatek. Po dobu přípravy odpovědi se rezervuje částka.

<em>03</em><strong>Model</strong>Model odpoví a odpověď se vrátí ve vašem formátu.

<em>04</em><strong>Stržení částky</strong>Jedno odečtení částky podle skutečných tokenů; zbývající rezerva se uvolní.

## [](https://ailoot.ai/docs/cs/how-it-works/#formats)Jeden klíč – tři formáty

Formát určuje cesta požadavku, nikoli model. Stejný model Claude lze zavolat přes OpenAI Chat, OpenAI Responses nebo Anthropic Messages – odpověď přijde ve formátu použité cesty.

| Formát | Cesta | Kdo jej používá |
| --- | --- | --- |
| OpenAI Chat Completions | `/v1/chat/completions` | OpenAI SDK, většina chatů a editorů, n8n, LangChain |
| OpenAI Responses | `/v1/responses` | Codex CLI, OpenAI Agents SDK, nové verze SDK |
| Anthropic Messages | `/v1/messages` | Claude Code, Anthropic SDK, Zed, Cline |
| Gemini | `/v1beta/models/{model}:generateContent` | Gemini CLI, Google GenAI SDK |

## [](https://ailoot.ai/docs/cs/how-it-works/#money)Peníze: rezerva a jedno odečtení částky

- Před odesláním nového textového požadavku Ailoot rezervuje odhad nákladů na vstup a obvyklou odpověď s ohledem na limit (`max_tokens`) a podmínky konkrétního modelu. Pokud se rezervace nevejde do volného zůstatku nebo limitu klíče, lze předávaný limit snížit pouze u modelu a metody, které ho skutečně dodržují, a nikdy pod 256 tokenů ani pod stanovené minimum odpovědi. U obrázků, videa a zvuku na výstupu zůstává rezervována celá cena výsledku.
- Po odpovědi se částka odečte jednou podle skutečné spotřeby. Nevyužitá rezerva se okamžitě vrátí na zůstatek.
- Pokud odpověď vyjde dráž než rezerva, rozdíl se odečte z volného zůstatku. Zůstatek nikdy neklesne pod nulu.
- Pokud prostředky nestačí ani na minimální rezervu, požadavek se neodesílá: dostanete srozumitelnou chybu 402 a nic se neodečte.
- Chyba, po které nevznikne výsledek, se neúčtuje.

Podrobnosti a příklad výpočtu najdete na stránce [Rezervace a stržení částky](https://ailoot.ai/docs/cs/billing/reserve/).

## [](https://ailoot.ai/docs/cs/how-it-works/#errors)Chyby s Request ID

Každá odpověď dostane identifikátor požadavku: v hlavičce `X-Request-ID` a v textu chyby. Chyby přicházejí v JSON zvoleného formátu, takže je SDK správně rozpozná. Pokud se něco nepovede, pošlete Request ID na [podporu](https://ailoot.ai/docs/cs/support/) – tak požadavek najdeme do minuty.

401 Unauthorized

```json
{
  "code": "API_KEY_REQUIRED",
  "error": {
    "code": "invalid_api_key",
    "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer <key>\". Request ID: 3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6.",
    "param": null,
    "reason": "invalid_api_key",
    "request_id": "3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6",
    "type": "invalid_request_error"
  },
  "message": "No API key was sent with the request. Nothing was charged. …"
}
```

## [](https://ailoot.ai/docs/cs/how-it-works/#streaming)Stream a časové limity

Streamované odpovědi (`stream: true`) používají Server-Sent Events. Placenou textovou odpověď Ailoot vrací po výpočtu ceny. Proto při `stream: true` formát zůstává streamovaný (SSE), text však přichází jako jeden blok po dokončení odpovědi modelu, nikoli po jednotlivých slovech. Pokud příprava odpovědi trvá déle než přibližně 15 sekund, ve streamech Chat Completions, Responses a Messages nejprve přicházejí pomocné řádky `: ping` (přibližně každých 10 sekund), poté řádek `: ailoot-charged-usd …` s odečtenou částkou a samotná data. SDK tyto řádky přeskakují.

Ve formátu Gemini nejsou pomocné řádky: odpověď `:streamGenerateContent` přichází celá po výpočtu. U modelů s podporou uvažování nastavte časový limit klienta s rezervou: několik minut je běžných.

## [](https://ailoot.ai/docs/cs/how-it-works/#headers)Hlavičky odpovědi

`X-Request-ID` je součástí každé odpovědi. Ostatní hlavičky Ailoot přidává k placeným textovým odpovědím:

| Hlavička | Co obsahuje |
| --- | --- |
| `X-Request-ID` | Identifikátor požadavku – vyžaduje jej podpora |
| `X-Ailoot-Charged-USD` | Kolik bylo odečteno za tento požadavek, v dolarech |
| `X-Ailoot-Output-Tokens` | Kolik tokenů odpovědi bylo zaplaceno |
| `X-Ailoot-Max-Tokens-Capped` | Limit odpovědi, na který byl snížen, protože zůstatek nestačil na plnou rezervu |
| `X-Ailoot-Notice-Code`, `X-Ailoot-Notice` | Vysvětlení, pokud se odpověď zastavila na limitu délky |

Pokud stream již začal pomocnými řádky, tyto údaje přijdou jako řádek s komentářem před daty, nikoli jako hlavička.

## [](https://ailoot.ai/docs/cs/how-it-works/#cache)Mezipaměť promptů

Pokud model podporuje ukládání do mezipaměti, opakovaně odeslaný dlouhý prefix (systémová instrukce, dokumenty) může být levnější. Ceny čtení a zápisu do mezipaměti jsou uvedeny na kartě modelu v [katalogu](https://ailoot.ai/models/cs/). O tom, zda se opakovaný prefix načte z mezipaměti (cache hit), rozhoduje vývojář modelu; Ailoot to nezaručuje.

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.