docs
Geldzaken

Reservering en afschrijving

Markdown

Hoe 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_tokens bij 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.

StapBerekeningBedrag
Daadwerkelijke invoer20 000 × $2 / 1 000 000$0.0400
Daadwerkelijk antwoord1 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_tokens en 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_tokens in — 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.

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

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.

Nog vragen? Stuur de Request ID en een beschrijving — we helpen je verder.Contact opnemen met support