Reservering en afschrijving
MarkdownHoe Ailoot kosten berekent: een reservering vóór het verzoek, één afschrijving erna en een saldo dat nooit negatief wordt.
In het kort
- Reservering — vóór de verzending van een nieuw tekstverzoek reserveert Ailoot een geschat bedrag voor de invoer en een typisch antwoord, volgens de aanvaarde voorwaarden van het verzoek. Voor afbeeldingen, video en audio als uitvoer blijven de volledige kosten van het resultaat gereserveerd.
- Afschrijving — één keer, op basis van het daadwerkelijke verbruik uit
usage. Het restant van de reservering wordt direct vrijgegeven. - Als er niet genoeg saldo is voor zelfs de minimale reservering — het verzoek wordt niet naar het model gestuurd en je krijgt fout 402 met een duidelijke melding. Er wordt niets afgeschreven.
Volledige gids
In het kort
- Prijs — in dollars per 1 miljoen invoer- en outputtokens (of per eenheid: afbeelding, videoseconde of tekens). De prijzen van elk model staan in de catalogus.
- Reservering — vóór de verzending van een nieuw tekstverzoek reserveert Ailoot een geschat bedrag voor de invoer en een typisch antwoord, volgens de aanvaarde voorwaarden van het verzoek. Voor afbeeldingen, video en audio als uitvoer blijven de volledige kosten van het resultaat gereserveerd.
- Een lagere limiet in plaats van afwijzing — als de berekende reservering niet binnen het beschikbare saldo of de sleutellimiet past, mag de antwoordlimiet alleen worden verlaagd voor het specifieke model en de specifieke methode die deze limiet naleven, en alleen tot een betaalbaar niveau dat niet onder het toepasselijke minimum ligt. Voor welke modellen dit werkt, staat hieronder.
- Afschrijving — één keer, op basis van het daadwerkelijke verbruik uit
usage. Het restant van de reservering wordt direct vrijgegeven. - Als het antwoord duurder is dan de reservering — het verschil wordt afgeschreven van het vrije saldo dat niet voor andere verzoeken is gereserveerd. De afschrijving is nooit hoger dan je saldo: je saldo wordt niet negatief.
- Als er niet genoeg saldo is voor zelfs de minimale reservering — het verzoek wordt niet naar het model gestuurd en je krijgt fout 402 met een duidelijke melding. Er wordt niets afgeschreven.
- Een fout zonder resultaat wordt niet in rekening gebracht. Als de verbinding wegvalt, controleer dan de Request ID in de dashboardgeschiedenis voordat je het verzoek opnieuw verstuurt.
Hoe de reservering wordt berekend
- Invoer wordt gereserveerd op basis van een schatting van de omvang van het verzoek en de ondersteunde bijlagen, niet op basis van reeds bekend daadwerkelijk verbruik. Voor nieuwe tekstverzoeken worden de body en de bijlagen geraamd volgens hun type. De berekening ‘4 tokens per byte, minimaal 4096 tokens’ heeft betrekking op eerder aanvaarde reserveringen van de oude versie en beschrijft geen nieuwe tekstreserveringen. Als een bijlage via een link is meegegeven (
fileData) of ingebouwde tools zijn ingeschakeld, worden voor ondersteunde tekstverzoeken de bijlagen en het gebruik van de tools afzonderlijk geraamd. Hun aanwezigheid op zich betekent niet dat het volledige invoervenster wordt gereserveerd. Voor eerdere reserveringen blijven de aanvaarde voorwaarden gelden; voor media als uitvoer blijft de berekening uitgaan van het volledige resultaat. - Output wordt voor de reservering van een nieuw tekstverzoek geraamd op basis van een typische antwoordlengte en de aanvaarde voorwaarden. De gevraagde limiet wordt ingesteld met
max_tokens(max_output_tokensbij Responses). De gevraagde limiet is niet automatisch gelijk aan het aantal tokens waarop de reservering is berekend en biedt bij een model zonder betrouwbare begrenzing geen garantie voor de werkelijke antwoordlengte. De standaardwaarde 4096 wordt alleen toegepast op de betrokken routes; de precieze regel hangt af van het model en de methode. - Prijs houdt voor nieuwe tekstreserveringen waarbij de voorwaarden van dit verzoek worden meegenomen rekening met de standaard- of prioriteitsmodus en de prijsschijven die bereikbaar zijn op basis van de geschatte invoer. Binnen de gekozen voorwaarden blijft de berekening conservatief; de modus flex verlaagt de reservering niet. Voor een prioriteitsverzoek kan de reservering uitgaan van de duurste toepasselijke modus, met inbegrip van priority, flex of fast. Eerder aanvaarde reserveringen zonder deze voorwaarden behouden de oorspronkelijke berekening tegen de hoogste tarieven.
- De limiet verlagen — wanneer de berekende reservering niet past en het specifieke model en de specifieke methode een begrensd antwoord mogelijk maken: de beschikbare middelen moeten volstaan voor de geschatte invoer en het minimale aantal outputtokens. De verlaagde limiet komt niet onder 256 tokens (1025 bij redeneren in het Anthropic-formaat). Het model krijgt de al verlaagde limiet.
Rekenvoorbeeld
Model claude-sonnet-5-5: invoer $2, output $10 per 1 miljoen tokens. Je hebt 20 000 tokens verstuurd; het model antwoordde met 1 200 tokens.
| Stap | Berekening | Bedrag |
|---|---|---|
| Daadwerkelijke invoer | 20 000 × $2 / 1 000 000 | $0.0400 |
| Daadwerkelijk antwoord | 1 200 × $10 / 1 000 000 | $0.0120 |
| Afgeschreven | één afschrijving op basis van het daadwerkelijke verbruik | $0.0520 |
In dit rekenvoorbeeld bedragen de werkelijke kosten $0.0520. De getoonde afschrijving veronderstelt dat de aanvaarde reservering en het beschikbare vrije saldo die kosten dekken. De omvang van de reservering wordt hier niet berekend: voor een nieuw tekstverzoek wordt die reservering afzonderlijk bepaald op basis van een schatting van de invoer en een typisch antwoord. De reservering kan groter of kleiner zijn dan de werkelijke kosten. Het ongebruikte deel van de reservering wordt vrijgegeven; de beperking van de afschrijving staat in de formule hieronder.
Daadwerkelijke afschrijving = min(volledige werkelijke kosten, aanvaarde reservering + vrij niet-gereserveerd saldo). Andere openstaande reserveringen blijven beschermd; het totale saldo wordt dus niet noodzakelijk nul. Je saldo wordt niet negatief. Als de werkelijke kosten hoger zijn dan de aanvaarde reservering plus het vrije, niet-gereserveerde saldo, blijft het niet-gedekte verschil een verlies voor Ailoot. Dat verschil wordt geen schuld van jou en wordt later niet alsnog geïnd.
Verbinding met de client verbroken
Het sluiten van de verbinding, een timeout van je applicatie of het niet lezen van een gereed antwoord annuleert het verzoek niet automatisch: een voltooid modelantwoord wordt één keer in rekening gebracht. Als het resultaat door een fout van Ailoot niet wordt geleverd, wordt het bedrag terugbetaald. Als de verbinding wegvalt, controleer dan de Request ID in de dashboardgeschiedenis voordat je het verzoek opnieuw verstuurt.
Waarom soms meer saldo nodig is
- Voor nieuwe tekstverzoeken wordt de reservering voor het antwoord berekend op basis van een typische lengte, rekening houdend met de opgegeven
max_tokensen de voorwaarden van het specifieke model. Dit is een schatting van de reservering, geen garantie voor de werkelijke lengte of kosten van het antwoord. - Bij modellen zonder een betrouwbare limiet voor de werkelijke antwoordlengte vormt de geschatte reservering geen lengtebeperking. Voor nieuwe tekstverzoeken wordt die schatting niet automatisch vervangen door de kosten van het langst mogelijke antwoord. Eerder aanvaarde reserveringen behouden hun oorspronkelijke voorwaarden.
- Afbeeldingen als invoer voegen een schatting van hun kosten aan de reservering toe.
- Agents (Claude Code, Codex CLI, Cline) versturen bij elke stap veel context: één stap kan tientallen centen reserveren. Houd ten minste een paar dollars op je saldo.
- Tip: stel een redelijke
max_tokensin — dit verlaagt de reservering bij modellen waarvan de antwoordlengte kan worden begrensd.
Promptcache
Bij modellen met caching gelden aparte prijzen voor schrijven naar en lezen uit de cache. Lezen is doorgaans meerdere keren goedkoper dan gewone invoer. De prijzen staan op de modelkaart in de catalogus.
Fout 402
Als er onvoldoende vrij saldo is voor zelfs de minimale reservering, stuurt Ailoot het verzoek niet door en antwoordt met 402 en code insufficient_balance. Als de totale bestedingslimiet van de sleutel is opgebruikt, krijg je code api_key_quota_exhausted. Als er op het account een schuld door een betwiste betaling bestaat, krijg je code payment_disputed: nieuwe verzoeken zijn opgeschort totdat die schuld is afgelost.
{
"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-…"
}
}Waar je de kosten kunt bekijken
De geschiedenis van verzoeken en afschrijvingen staat in het dashboard op ailoot.ai. Voor elk verzoek zie je het model, de tokens en het bedrag.