Varaus ja veloitus
MarkdownNäin Ailoot laskee summat: varaus ennen pyyntöä, yksi veloitus sen jälkeen ja saldo, joka ei koskaan muutu negatiiviseksi.
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.
Koko opas
Tiivistetysti
- Hinta — dollareina 1 miljoonaa syöte- ja tulostetokenia kohti (tai yksikköä kohti: kuva, videosekunti, merkit). Kunkin mallin hinnat on ilmoitettu luettelossa.
- 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.
- 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.
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_tokensResponsesissa). 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.
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.
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.
Miksi joskus tarvitaan enemmän saldoa
- Uusien tekstipyyntöjen vastausvaraus lasketaan tyypillisen vastauspituuden perusteella ottaen huomioon parametrille
max_tokensannettu 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.
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.
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.
{
"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-…"
}
}Mistä näet kulutuksen
Pyyntöjen ja veloitusten historia on hallintapaneelissa osoitteessa ailoot.ai. Jokaisesta pyynnöstä näkyvät malli, tokenit ja summa.