Ako to funguje

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.

• 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.

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 – požiadavku tak nájdeme do minúty.

{
  "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. …"
}

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.

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

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

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. O využití cache rozhoduje vývojár modelu, Ailoot ho nezaručuje.