Näin se toimii

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.

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

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 — näin löydämme pyynnön minuutissa.

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

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.

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

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

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. Mallin kehittäjä päättää välimuistiosumasta; Ailoot ei takaa sitä.