Source: https://ailoot.ai/docs/fi/billing/reserve/ Canonical: https://ailoot.ai/docs/fi/billing/reserve/ Language: fi [Raha](https://ailoot.ai/docs/fi/) # Varaus ja veloitus [Markdown](https://ailoot.ai/docs/fi/billing/reserve/index.md) Näin Ailoot laskee summat: varaus ennen pyyntöä, yksi veloitus sen jälkeen ja saldo, joka ei koskaan muutu negatiiviseksi. ## [](https://ailoot.ai/docs/fi/billing/reserve/#summary)Tiivistetysti - **Varaus** — ennen uuden tekstipyynnön lähettämistä Ailoot varaa arvioidun syötteen ja tyypillisen vastauksen kustannukset pyynnölle hyväksyttyjen ehtojen mukaisesti. Kuville, videolle ja äänelle tulosteena säilyy tuloksen koko kustannuksen kattava varaus. - **Veloitus** — kerran, toteutuneen kulutuksen perusteella kentästä `usage`. Käyttämätön varaus vapautetaan heti. - **Jos saldo ei riitä edes vähimmäisvaraukseen** — pyyntöä ei lähetetä mallille, ja saat virheen 402 ymmärrettävällä tekstillä. Mitään ei veloiteta. ## [](https://ailoot.ai/docs/fi/billing/reserve/#ailoot-reserve-summary-details)Tiivistetysti - **Hinta** — dollareina 1 miljoonaa syöte- ja tulostetokenia kohti (tai yksikköä kohti: kuva, videosekunti, merkit). Kunkin mallin hinnat on ilmoitettu [luettelossa](https://ailoot.ai/models/fi/). - **Varaus** — ennen uuden tekstipyynnön lähettämistä Ailoot varaa arvioidun syötteen ja tyypillisen vastauksen kustannukset pyynnölle hyväksyttyjen ehtojen mukaisesti. Kuville, videolle ja äänelle tulosteena säilyy tuloksen koko kustannuksen kattava varaus. - **Pienempi raja hylkäämisen sijaan** — jos laskettu varaus ei mahdu käytettävissä olevaan saldoon tai avaimen rajaan, vastausrajaa voidaan pienentää vain kyseisellä mallilla ja metodilla, jotka noudattavat sitä, ja vain maksettavissa olevaan määrään sovellettavaa vähimmäismäärää alittamatta. Mallit, joilla tämä toimii, löytyvät [alta](https://ailoot.ai/docs/fi/billing/reserve/#reserve). - **Veloitus** — kerran, toteutuneen kulutuksen perusteella kentästä `usage`. Käyttämätön varaus vapautetaan heti. - **Jos vastaus maksaa varausta enemmän** — erotus otetaan vapaasta saldosta, jota muut varaukset eivät sido. Veloitus ei koskaan ylitä saldoasi: saldo ei muutu negatiiviseksi. - **Jos saldo ei riitä edes vähimmäisvaraukseen** — pyyntöä ei lähetetä mallille, ja saat virheen 402 ymmärrettävällä tekstillä. Mitään ei veloiteta. - **Virheestä ilman tulosta ei veloiteta**. Jos yhteys katkesi, tarkista pyyntö Request ID:n avulla hallintapaneelin historiasta ennen kuin lähetät sen uudelleen. ## [](https://ailoot.ai/docs/fi/billing/reserve/#reserve)Näin varaus lasketaan - **Syöte** varataan pyynnön koon ja tuettujen liitteiden arvion perusteella, ei jo tiedossa olevan toteutuneen kulutuksen mukaan. Uusissa tekstipyynnöissä pyynnön runko ja liitteet arvioidaan niiden tyypin mukaan. Laskenta ”4 tokenia tavua kohti, mutta vähintään 4096 tokenia” koskee vanhan version aiemmin hyväksyttyjä varauksia eikä kuvaa uusia tekstivarauksia. Jos liite lähetetään linkkinä (`fileData`) tai sisäänrakennetut työkalut ovat käytössä, tuetuissa tekstipyynnöissä huomioidaan erilliset arviot liitteistä ja työkalujen käytöstä; pelkkä niiden mukanaolo ei tarkoita koko syöteikkunan varaamista. Aiemmissa varauksissa säilyvät hyväksytyt ehdot, ja tulosteena tuotettavalle medialle lasketaan koko tulos. - **Tuloste** arvioidaan uuden tekstipyynnön varausta varten tyypillisen vastauspituuden ja hyväksyttyjen ehtojen perusteella. Pyydetty raja asetetaan parametrilla `max_tokens` (`max_output_tokens` Responsesissa). Pyydetty raja ei automaattisesti vastaa tokenimäärää, jonka perusteella varaus on laskettu, eikä takaa todellista vastauspituutta mallilla, jolla ei ole luotettavaa rajoitusta. Lähtöarvoa 4096 käytetään vain sitä koskevilla reiteillä; tarkka sääntö riippuu mallista ja metodista. - **Hinta** — uusien tekstivarausten laskennassa otetaan pyynnön ehtojen mukaan huomioon vakio- tai prioriteettitila sekä hintaportaat, jotka voivat tulla kyseeseen arvioidulla syötemäärällä. Valittujen ehtojen puitteissa laskenta pysyy konservatiivisena; flex-tila ei pienennä varausta. Priorisoidun pyynnön varaus voi huomioida kalleimman sovellettavan tilan, mukaan lukien priority, flex tai fast. Aiemmin ilman näitä ehtoja hyväksytyissä varauksissa säilyy alkuperäinen enimmäishintoihin perustuva laskenta. - **Rajan pienentäminen** — kun laskettu varaus ei mahdu käytettävissä oleviin varoihin ja kyseinen malli sekä metodi sallivat vastauksen rajoittamisen, varojen on katettava arvioitu syöte ja tulosteen vähimmäismäärä. Pienennetty raja ei alita 256 tokenia (1025 ajattelulla Anthropic-muodossa). Malli saa jo pienennetyn rajan. Jos laskettu varaus ei mahdu käytettävissä olevaan saldoon tai avaimen rajaan, Ailoot voi tuetulla mallilla ja metodilla pienentää parametrin `max_tokens` (`max_output_tokens` Responsesissa) arvon maksettavissa olevaan määrään, mutta ei alle 256 tokenin tai kyseisen metodin korkeamman vähimmäismäärän, ja ilmoittaa siitä otsakkeessa `X-Ailoot-Max-Tokens-Capped`. Pienentämismahdollisuus tarkistetaan kyseiselle tekstimallille ja metodille. Sitä sovelletaan tuettuihin Geminin tekstireitteihin mallin omassa Gemini-muodossa ja Anthropic Messages -muodossa; `deepseek-ai/deepseek-v4.1-flash`, `meta/llama-3.2-11b-vision-instruct`, `meta/muse-glimmer-30b`, `nvidia/ising-calibration-1.5-31b`, `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning`, `nvidia/nemotron-3-super-120b-a12b`, `nvidia/nemotron-3-ultra-550b-a55b`, `nvidia/nemotron-3.5-content-safety`, `nvidia/nemotron-3.5-lightning-30b-a3b`, `nvidia/riva-translate-4b-instruct-v1.1`, `nvidia/riva-translate-4b-instruct-v2`, `poolside/laguna-xs-2.1`, `z-ai/glm-5.3-flash` — Chat Completions- ja Messages-muodoissa (siellä, missä malli tukee niitä). Jos kyseinen malli ei noudata sille lähetettyä vastausrajaa, Ailoot ei lupaa rajoittaa todellista vastauspituutta. Uusien tekstipyyntöjen varaus perustuu silti syötteen ja tyypillisen vastauksen arvioon; jos vähimmäisvaraukseen ei ole riittävästi varoja, palautetaan virhe 402 eikä pyyntöä lähetetä. Kenttää `previous_response_id` ja sisäänrakennettuja työkaluja `web_search` tai `code_interpreter` käyttävissä uusissa tekstipyynnöissä huomioidaan erilliset arviot tallennetusta kontekstista ja työkalujen käytöstä; niissä ei automaattisesti siirrytä koko syöteikkunan kustannukseen. Aiemmin hyväksytyt varaukset säilyttävät alkuperäiset ehtonsa. Kuville, videolle ja äänelle tulosteena varataan tuloksen koko kustannus. ## [](https://ailoot.ai/docs/fi/billing/reserve/#example)Laskuesimerkki Malli `claude-sonnet-5-5`: syöte $2, tuloste $10 / 1 miljoonaa tokenia. Lähetit 20 000 tokenia, ja malli vastasi 1 200 tokenilla. | Vaihe | Laskenta | Summa | | --- | --- | --- | | Toteutunut syöte | 20 000 × $2 / 1 000 000 | $0.0400 | | Toteutunut vastaus | 1 200 × $10 / 1 000 000 | $0.0120 | | **Veloitettu** | yksi veloitus toteutuneen kulutuksen mukaan | **$0.0520** | Esitetyssä laskuesimerkissä toteutunut kustannus on $0.0520. Näytetty veloitus edellyttää, että hyväksytty varaus ja käytettävissä oleva vapaa saldo kattavat tämän kustannuksen. Varauksen määrää ei lasketa tässä: uudelle tekstipyynnölle se määritetään erikseen arvioidun syötteen ja tyypillisen vastauksen perusteella, ja se voi olla toteutunutta kustannusta suurempi tai pienempi. Käyttämätön varaus vapautetaan; veloituksen rajoitus esitetään alla olevassa kaavassa. Toteutunut veloitus = `min(todelliset kokonaiskustannukset, hyväksytty varaus + vapaa varaamaton saldo)`. Muut avoimet varaukset pysyvät suojattuina, joten kokonaissaldo ei välttämättä laske nollaan. Saldo ei muutu negatiiviseksi. Jos toteutunut kustannus ylittää hyväksytyn varauksen ja vapaan varaamattoman saldon yhteismäärän, kattamatta jäävä erotus jää Ailootin tappioksi: siitä ei tule velkaasi eikä sitä peritä myöhemmin. ## [](https://ailoot.ai/docs/fi/billing/reserve/#disconnect)Asiakkaan yhteyden katkeaminen Yhteyden sulkeminen, sovelluksesi aikakatkaisu tai valmiin vastauksen lukematta jättäminen ei peruuta pyyntöä automaattisesti: mallin valmis vastaus veloitetaan kerran. Jos tulosta ei toimiteta Ailootin syystä, rahat palautetaan. Jos yhteys katkesi, tarkista pyyntö Request ID:n avulla hallintapaneelin historiasta ennen kuin lähetät sen uudelleen. ## [](https://ailoot.ai/docs/fi/billing/reserve/#bigger-reserve)Miksi joskus tarvitaan enemmän saldoa - Uusien tekstipyyntöjen vastausvaraus lasketaan tyypillisen vastauspituuden perusteella ottaen huomioon parametrille `max_tokens` annettu arvo ja kyseisen mallin ehdot. Kyse on varausarviosta, ei takuusta vastauksen todellisesta pituudesta tai kustannuksesta. - Malleilla, joilla ei ole luotettavaa rajaa todelliselle vastaukselle, varausarvio ei muutu pituusrajoitukseksi. Uusissa tekstipyynnöissä sitä ei automaattisesti korvata pisimmän mahdollisen vastauksen kustannuksella. Aiemmin hyväksytyt varaukset säilyttävät alkuperäiset ehtonsa. - Syötekuvien arvioitu hinta lisätään varaukseen. - Agentit (Claude Code, Codex CLI, Cline) lähettävät suuren kontekstin jokaisella askeleella: yksi askel voi varata kymmeniä senttejä. Pidä saldossa ainakin muutama dollari. - Vinkki: määritä kohtuullinen `max_tokens` — tämä pienentää varausta malleilla, joiden vastauspituutta voi rajoittaa. ## [](https://ailoot.ai/docs/fi/billing/reserve/#cache)Kehotteiden välimuisti Välimuistia tukevilla malleilla on erilliset hinnat välimuistiin kirjoittamiselle ja lukemiselle. Lukeminen on yleensä moninkertaisesti tavallista syötettä halvempaa. Hinnat näkyvät luettelon mallikortissa. ## [](https://ailoot.ai/docs/fi/billing/reserve/#402)Virhe 402 Jos vapaa saldo ei riitä edes vähimmäisvaraukseen, Ailoot ei lähetä pyyntöä ja vastaa koodilla 402 sekä virhekoodilla `insufficient_balance`. Jos avaimen kokonaiskulutusraja on käytetty — koodi `api_key_quota_exhausted`. Jos tilillä on velkaa kiistetystä maksusta — koodi `payment_disputed`: uudet pyynnöt on keskeytetty velan maksamiseen asti. 402 Payment Required ```json { "error": { "code": "insufficient_balance", "reason": "insufficient_balance", "type": "insufficient_quota", "param": null, "message": "Your balance is too low to start this request. … Request ID: 5c0e7a1d-….", "request_id": "5c0e7a1d-…" } } ``` ## [](https://ailoot.ai/docs/fi/billing/reserve/#usage)Mistä näet kulutuksen Pyyntöjen ja veloitusten historia on hallintapaneelissa osoitteessa [ailoot.ai](https://ailoot.ai). Jokaisesta pyynnöstä näkyvät malli, tokenit ja summa. 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.