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

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

# Ako to funguje

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

Čo sa deje s požiadavkou medzi vaším programom a modelom.

Požiadavku do Ailoot API odosielate rovnako, ako by ste ju poslali priamo do OpenAI, Anthropic alebo Google. Ailoot overí kľúč a zostatok, odovzdá požiadavku modelu, vráti odpoveď v rovnakom formáte a zaúčtuje sumu podľa skutočnej spotreby.

<em>01</em><strong>Požiadavka</strong>Váš klient posiela požiadavku na api.ailoot.ai s kľúčom sk-…

<em>02</em><strong>Kontrola a rezervácia</strong>Kľúč, limity, zostatok. Na čas prípravy odpovede sa rezervuje suma.

<em>03</em><strong>Model</strong>Model odpovie a odpoveď sa vráti vo vašom formáte.

<em>04</em><strong>Zaúčtovanie</strong>Jedno zaúčtovanie podľa skutočných tokenov; zvyšok rezervácie sa uvoľní.

## [](https://ailoot.ai/docs/sk/how-it-works/#formats)Jeden kľúč – tri formáty

Formát určuje cesta požiadavky, nie model. Ten istý model Claude možno zavolať cez OpenAI Chat, OpenAI Responses alebo Anthropic Messages – odpoveď príde vo formáte zavolanej cesty.

| Formát | Cesta | Kto ho používa |
| --- | --- | --- |
| OpenAI Chat Completions | `/v1/chat/completions` | OpenAI SDK, väčšina chatov a editorov, n8n, LangChain |
| OpenAI Responses | `/v1/responses` | Codex CLI, OpenAI Agents SDK, nové verzie 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/sk/how-it-works/#money)Financie: rezervácia a jedno zaúčtovanie

- Pred odoslaním novej textovej požiadavky Ailoot rezervuje odhadovanú cenu vstupu a typickej odpovede s prihliadnutím na limit (`max_tokens`) a podmienky konkrétneho modelu. Ak sa rezervácia nezmestí do voľného zostatku alebo limitu kľúča, odosielaný limit možno znížiť iba pri modeli a metóde, ktoré ho skutočne dodržiavajú, a nie pod 256 tokenov ani pod stanovené minimum odpovede. Pri obrázkoch, videu a zvuku na výstupe sa naďalej rezervuje plná cena výsledku.
- Po odpovedi nasleduje jedno zaúčtovanie podľa skutočnej spotreby. Nevyužitá rezervácia sa okamžite vráti do zostatku.
- Ak je odpoveď drahšia než rezervácia, rozdiel sa odpočíta z voľného zostatku. Zostatok nikdy neklesne pod nulu.
- Ak prostriedky nestačia ani na minimálnu rezerváciu, požiadavka sa neodošle: dostanete zrozumiteľnú chybu 402 a nič sa nezaúčtuje.
- Chyba bez výsledku sa neúčtuje.

Podrobnosti a príklad výpočtu nájdete na stránke [Rezervácia a účtovanie](https://ailoot.ai/docs/sk/billing/reserve/).

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

Každá odpoveď dostane identifikátor požiadavky: v hlavičke `X-Request-ID` a v texte chyby. Chyby prichádzajú vo formáte JSON príslušného API, preto ich SDK správne rozpoznajú. Ak sa niečo nepodarilo, pošlite Request ID [podpore](https://ailoot.ai/docs/sk/support/) – požiadavku tak nájdeme do minúty.

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/sk/how-it-works/#streaming)Stream a časové limity

Streamované odpovede (`stream: true`) prichádzajú ako Server-Sent Events. Platenú textovú odpoveď Ailoot odovzdá po výpočte ceny. Preto pri `stream: true` zostáva formát streamovaný (SSE), ale text príde v jednom bloku po dokončení modelu, nie po jednotlivých slovách. Ak sa odpoveď pripravuje dlhšie než približne 15 sekúnd, v streamoch Chat Completions, Responses a Messages najprv prichádzajú služobné riadky `: ping` (približne raz za 10 sekúnd), potom riadok `: ailoot-charged-usd …` so zaúčtovanou sumou a samotné údaje. SDK tieto riadky preskakujú.

Vo formáte Gemini nie sú služobné riadky: odpoveď `:streamGenerateContent` príde celá po výpočte ceny. Pri modeloch s uvažovaním nastavte časový limit klienta s rezervou: niekoľko minút je bežných.

## [](https://ailoot.ai/docs/sk/how-it-works/#headers)Hlavičky odpovede

`X-Request-ID` prichádza v každej odpovedi. Ostatné hlavičky Ailoot pridáva k plateným textovým odpovediam:

| Hlavička | Čo obsahuje |
| --- | --- |
| `X-Request-ID` | Identifikátor požiadavky – vyžaduje ho podpora |
| `X-Ailoot-Charged-USD` | Suma zaúčtovaná za túto požiadavku v dolároch |
| `X-Ailoot-Output-Tokens` | Počet zaplatených tokenov odpovede |
| `X-Ailoot-Max-Tokens-Capped` | Limit odpovede, na ktorý sa znížil, pretože zostatok nestačil na celú rezerváciu |
| `X-Ailoot-Notice-Code`, `X-Ailoot-Notice` | Vysvetlenie, ak sa odpoveď zastavila na limite dĺžky |

Ak sa stream už začal služobnými riadkami, tieto údaje prídu pred dátami ako riadok komentára namiesto hlavičky.

## [](https://ailoot.ai/docs/sk/how-it-works/#cache)Cache promptov

Ak model podporuje cache, opätovné odoslanie dlhého prefixu (systémová inštrukcia, dokumenty) môže byť lacnejšie. Ceny čítania a zápisu do cache nájdete na karte modelu v [katalógu](https://ailoot.ai/models/sk/). O využití cache rozhoduje vývojár modelu, Ailoot ho nezaručuje.

Máte ďalšie otázky? Pošlite Request ID a opis problému – pomôžeme vám ho vyriešiť.[Napísať podpore](mailto:support@ailoot.ai)

## Ailoot · Spoločnosť a jej portfólio projektov





Ailoot stavia na dlhodobých prevádzkových skúsenostiach, širokej klientskej základni, stabilných službách a priebežnom sledovaní KPI.





Spoločnosť a jej portfólio projektov: milióny zákazníkov; mesačné tržby v miliardách.





Ailoot využíva tieto prevádzkové skúsenosti na poskytovanie prístupu cez API k funkciám AI v produktoch zákazníkov, agentoch, aplikáciách a automatizáciách.