dokumentation
Ekonomi

Reservering och debitering

Markdown

Så beräknar Ailoot kostnader: reservering före anropet, en debitering efteråt och ett saldo som aldrig blir negativt.

Kortfattat

  • Reservering — innan ett nytt textanrop skickas reserverar Ailoot en uppskattning av indata och ett typiskt svar enligt de accepterade villkoren för anropet. För bilder, video och ljud som utdata behålls reserveringen för hela resultatkostnaden.
  • Debitering — en gång, utifrån faktisk förbrukning i usage. Återstående reservering frigörs direkt.
  • Om saldot inte ens räcker till minsta reservering — anropet skickas inte till modellen, och du får fel 402 med en begriplig förklaring. Ingenting debiteras.
Fullständig guide

Kortfattat

  • Pris — i dollar per 1 miljon indata- och utdatatoken (eller per enhet: bild, videosekund, tecken). Priser för varje modell finns i katalogen.
  • Reservering — innan ett nytt textanrop skickas reserverar Ailoot en uppskattning av indata och ett typiskt svar enligt de accepterade villkoren för anropet. För bilder, video och ljud som utdata behålls reserveringen för hela resultatkostnaden.
  • Lägre gräns i stället för avvisning — om den beräknade reserveringen inte ryms inom tillgängligt saldo eller nyckelns gräns får svarsgränsen bara sänkas för den exakta modell och metod som följer den, och endast till en volym som kan betalas utan att underskrida tillämplig miniminivå. Vilka modeller detta gäller visas nedan.
  • Debitering — en gång, utifrån faktisk förbrukning i usage. Återstående reservering frigörs direkt.
  • Om svaret kostar mer än reserveringen — mellanskillnaden tas från tillgängligt saldo som inte är bundet av andra reserveringar. Debiteringen överstiger aldrig ditt saldo: saldot blir inte negativt.
  • Om saldot inte ens räcker till minsta reservering — anropet skickas inte till modellen, och du får fel 402 med en begriplig förklaring. Ingenting debiteras.
  • Fel utan resultat debiteras inte. Om anslutningen bröts kontrollerar du anropet med Request ID i kontrollpanelens historik innan du skickar det igen.

Så beräknas reserveringen

  • Indata reserveras utifrån en uppskattning av anropets storlek och de bilagor som stöds, inte utifrån redan känd faktisk förbrukning. För nya textanrop uppskattas anropskroppen och bilagorna efter deras typ. Beräkningen ”4 token per byte, men minst 4096 token” gäller tidigare accepterade reserveringar från den äldre versionen och beskriver inte nya textreserveringar. Om bilagan anges som en länk (fileData) eller inbyggda verktyg är aktiverade görs separata uppskattningar av bilagor och verktygsarbete för de textanrop som stöds; att de finns med innebär inte att hela indatafönstret reserveras. För tidigare reserveringar gäller de accepterade villkoren, och för media som utdata beräknas hela resultatet.
  • Utdata uppskattas för reserveringen av ett nytt textanrop utifrån en typisk svarslängd och de accepterade villkoren. Den begärda gränsen anges med max_tokens (max_output_tokens i Responses). Den begärda gränsen är inte automatiskt lika med det tokenantal som reserveringen beräknats för och garanterar inte den faktiska svarslängden hos en modell utan tillförlitlig begränsning. Utgångsvärdet 4096 används endast för de berörda rutterna; den exakta regeln beror på modellen och metoden.
  • Pris — för nya textreserveringar beaktas villkoren för anropet: standard- eller prioritetsläge och de prissteg som kan bli aktuella med den uppskattade indatamängden. Inom de valda villkoren förblir beräkningen konservativ; flex-läget minskar inte reserveringen. För ett prioriterat anrop kan reserveringen ta hänsyn till det dyraste tillämpliga läget, inklusive priority, flex eller fast. Tidigare accepterade reserveringar utan dessa villkor behåller den ursprungliga beräkningen med maximala priser.
  • Sänkning av gränsen — när den beräknade reserveringen inte ryms och den exakta modellen och metoden tillåter en begränsning av svaret måste de tillgängliga medlen täcka uppskattade indata och minsta utdatavolym. Den sänkta gränsen går inte under 256 token (1025 med resonemang i Anthropic-format). Modellen får den redan sänkta gränsen.

Räkneexempel

Modell claude-sonnet-5-5: indata $2, utdata $10 per 1 miljon token. Du skickade 20 000 token och modellen svarade med 1 200 token.

StegBeräkningBelopp
Faktiska indata20 000 × $2 / 1 000 000$0.0400
Faktiskt svar1 200 × $10 / 1 000 000$0.0120
Debiteraten debitering utifrån faktisk förbrukning$0.0520

I det visade räkneexemplet är den faktiska kostnaden $0.0520. Den angivna debiteringen förutsätter att den accepterade reserveringen och tillgängligt fritt saldo täcker kostnaden. Reserveringens storlek beräknas inte här: för ett nytt textanrop bestäms den separat utifrån uppskattade indata och ett typiskt svar och kan vara större eller mindre än den faktiska kostnaden. Oanvänd reservering frigörs; debiteringens begränsning anges i formeln nedan.

Faktisk debitering = min(full faktisk kostnad, godkänd reservation + fritt saldo som inte är reserverat). Andra öppna reserveringar förblir skyddade; totalsaldot blir därför inte nödvändigtvis noll. Saldot blir inte negativt. Om den faktiska kostnaden överstiger summan av den accepterade reserveringen och det fria, oreserverade saldot blir den otäckta skillnaden en förlust för Ailoot: den blir inte din skuld och krävs inte in senare.

När klienten kopplar från

Att stänga anslutningen, en timeout i din app eller att inte läsa ett redan färdigt svar avbryter inte anropet automatiskt: modellens färdiga svar debiteras en gång. Om resultatet inte levereras på grund av Ailoot återbetalas beloppet. Om anslutningen bröts kontrollerar du anropet med Request ID i kontrollpanelens historik innan du skickar det igen.

Varför det ibland behövs ett större saldo

  • För nya textanrop beräknas reserveringen för svaret utifrån en typisk svarslängd, med hänsyn till angivet max_tokens och villkoren för den exakta modellen. Detta är en uppskattning av reserveringen, inte en garanti för svarets faktiska längd eller kostnad.
  • För modeller utan en tillförlitlig gräns för det faktiska svaret blir uppskattningen av reserveringen inte en längdbegränsning. För nya textanrop ersätts den inte automatiskt med kostnaden för det längsta möjliga svaret. Tidigare accepterade reserveringar behåller sina ursprungliga villkor.
  • Bilder som indata ökar reserveringen med en uppskattning av bildkostnaden.
  • Agenter (Claude Code, Codex CLI, Cline) skickar stor kontext i varje steg: ett steg kan reservera tiotals cent. Ha åtminstone några dollar på saldot.
  • Tips: ange ett rimligt max_tokens — detta minskar reserveringen för modeller vars svarslängd kan begränsas.

Prompt-cache

Modeller med cachning har separata priser för skrivning till och läsning från cache. Läsning är vanligen flera gånger billigare än vanliga indata. Priserna visas på modellens katalogpost.

Fel 402

Om tillgängligt saldo inte ens täcker minsta reservering skickar Ailoot inte anropet utan svarar med 402 och koden insufficient_balance. Om nyckelns totala utgiftsgräns är förbrukad är koden api_key_quota_exhausted. Om kontot har en skuld på grund av en bestridd betalning är koden payment_disputed: nya anrop pausas tills skulden är betald.

402 Payment Required
{
  "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-…"
  }
}

Var du ser kostnaderna

Historiken över anrop och debiteringar finns i kontrollpanelen på ailoot.ai. För varje anrop visas modell, token och belopp.

Har du fler frågor? Skicka Request ID och en beskrivning, så hjälper vi dig.Kontakta supporten