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

[Aloitus](https://ailoot.ai/docs/fi/) 

# Näin se toimii

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

Mitä pyynnölle tapahtuu ohjelmasi ja mallin välillä.

Lähetät pyynnön Ailoot APIin samalla tavalla kuin suoraan OpenAIhin, Anthropiciin tai Googleen. Ailoot tarkistaa avaimen ja saldon, välittää pyynnön mallille, palauttaa vastauksen samassa muodossa ja veloittaa toteutuneen kulutuksen mukaan.

<em>01</em><strong>Pyyntö</strong>Asiakasohjelmasi lähettää pyynnön osoitteeseen api.ailoot.ai avaimella sk-…

<em>02</em><strong>Tarkistus ja varaus</strong>Avain, rajoitukset ja saldo. Summa varataan vastauksen ajaksi.

<em>03</em><strong>Malli</strong>Malli vastaa, ja vastaus palautuu käyttämässäsi muodossa.

<em>04</em><strong>Veloitus</strong>Yksi veloitus toteutuneiden tokenien mukaan; loput varauksesta vapautetaan.

## [](https://ailoot.ai/docs/fi/how-it-works/#formats)Yksi avain — kolme muotoa

Muodon määrittää pyynnön polku, ei malli. Samaa Claude-mallia voi kutsua OpenAI Chatin, OpenAI Responsesin tai Anthropic Messagesin kautta — vastaus saapuu kutsumasi polun muodossa.

| Muoto | Polku | Käyttäjät |
| --- | --- | --- |
| OpenAI Chat Completions | `/v1/chat/completions` | OpenAI SDK, useimmat chatit ja editorit, n8n, LangChain |
| OpenAI Responses | `/v1/responses` | Codex CLI, OpenAI Agents SDK, uudet SDK-versiot |
| Anthropic Messages | `/v1/messages` | Claude Code, Anthropic SDK, Zed, Cline |
| Gemini | `/v1beta/models/{model}:generateContent` | Gemini CLI, Google GenAI SDK |

## [](https://ailoot.ai/docs/fi/how-it-works/#money)Raha: varaus ja yksi veloitus

- Ennen uuden tekstipyynnön lähettämistä Ailoot varaa arvioidun syötteen ja tyypillisen vastauksen kustannukset ottaen huomioon rajan (`max_tokens`) sekä kyseisen mallin ehdot. Jos varaus ei mahdu vapaaseen saldoon tai avaimen rajaan, lähetettävää rajaa voidaan pienentää vain mallilla ja metodilla, jotka todella noudattavat sitä, eikä alle 256 tokenin tai vastaukselle asetetun vähimmäismäärän. Kuville, videolle ja äänelle tulosteena säilyy tuloksen koko kustannuksen kattava varaus.
- Vastauksen jälkeen yksi veloitus toteutuneen kulutuksen mukaan. Käyttämätön varaus palautetaan saldoon heti.
- Jos vastaus maksaa varausta enemmän, erotus otetaan vapaasta saldosta. Saldo ei koskaan muutu negatiiviseksi.
- Jos saldo ei riitä edes vähimmäisvaraukseen, pyyntöä ei lähetetä: saat ymmärrettävän virheen 402, eikä mitään veloiteta.
- Virheestä, jonka jälkeen ei ole tulosta, ei veloiteta.

Lisätiedot ja laskuesimerkki löytyvät sivulta [Varaus ja veloitus](https://ailoot.ai/docs/fi/billing/reserve/).

## [](https://ailoot.ai/docs/fi/how-it-works/#errors)Virheet ja Request ID

Jokainen vastaus saa pyynnön tunnisteen otsakkeessa `X-Request-ID` ja virhetekstissä. Virheet saapuvat JSONina kutsumasi muodon mukaisesti, joten SDK:t tunnistavat ne oikein. Jos jokin menee pieleen, lähetä Request ID [tukeen](https://ailoot.ai/docs/fi/support/) — näin löydämme pyynnön minuutissa.

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/fi/how-it-works/#streaming)Virtavastaukset ja aikakatkaisut

Virtavastaukset (`stream: true`) saapuvat Server-Sent Events -muodossa. Ailoot palauttaa maksullisen tekstivastauksen hinnan laskemisen jälkeen. Siksi asetuksella `stream: true` muoto pysyy virtamuotoisena (SSE), mutta teksti saapuu yhtenä lohkona mallin valmistuttua, ei sana kerrallaan. Jos vastauksen valmistuminen kestää yli noin 15 sekuntia, Chat Completions-, Responses- ja Messages-virroissa saapuvat ensin palvelurivit `: ping` (noin 10 sekunnin välein), sitten rivi `: ailoot-charged-usd …` veloitussummalla ja itse tiedot. SDK:t ohittavat tällaiset rivit.

Gemini-muodossa ei ole palvelurivejä: vastaus `:streamGenerateContent` saapuu kokonaisena laskennan jälkeen. Jätä asiakkaan aikakatkaisuun pelivaraa päättelymalleille: muutama minuutti on normaalia.

## [](https://ailoot.ai/docs/fi/how-it-works/#headers)Vastauksen otsakkeet

`X-Request-ID` saapuu jokaisessa vastauksessa. Ailoot lisää muut otsakkeet maksullisiin tekstivastauksiin:

| Otsake | Sisältö |
| --- | --- |
| `X-Request-ID` | Pyynnön tunniste — tuki pyytää sitä |
| `X-Ailoot-Charged-USD` | Tästä pyynnöstä veloitettu summa dollareina |
| `X-Ailoot-Output-Tokens` | Maksettujen vastaustokenien määrä |
| `X-Ailoot-Max-Tokens-Capped` | Pienennetty vastausraja, koska saldo ei riittänyt koko varaukseen |
| `X-Ailoot-Notice-Code`, `X-Ailoot-Notice` | Selitys, jos vastaus pysähtyi pituusrajaan |

Jos virta on jo alkanut palveluriveillä, nämä tiedot saapuvat kommenttirivinä ennen tietoja, eivät otsakkeena.

## [](https://ailoot.ai/docs/fi/how-it-works/#cache)Kehotteiden välimuisti

Jos malli tukee välimuistia, uudelleen lähetetty pitkä etuliite (järjestelmäohje, asiakirjat) voi maksaa vähemmän. Välimuistin luku- ja kirjoitushinnat näkyvät mallikortissa [luettelossa](https://ailoot.ai/models/fi/). Mallin kehittäjä päättää välimuistiosumasta; Ailoot ei takaa sitä.

Onko vielä kysyttävää? Lähetä Request ID ja kuvaus — autamme selvittämään asian.[Ota yhteyttä tukeen](mailto:support@ailoot.ai)

## Ailoot · Yritys ja sen projektisalkku





Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.





Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.





Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.