documentatie
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 het versturen van een nieuw tekstverzoek reserveert Ailoot een bedrag op basis van een schatting van de invoer en een typisch antwoord volgens de geaccepteerde voorwaarden van het verzoek. Voor afbeeldingen, video en audio als output blijft de volledige reservering voor de kosten van het resultaat gelden.
  • 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 het versturen van een nieuw tekstverzoek reserveert Ailoot een bedrag op basis van een schatting van de invoer en een typisch antwoord volgens de geaccepteerde voorwaarden van het verzoek. Voor afbeeldingen, video en audio als output blijft de volledige reservering voor de kosten van het resultaat gelden.
  • Een lagere limiet in plaats van afwijzing — als de berekende reservering niet binnen het beschikbare saldo of de sleutellimiet past, kan de antwoordlimiet alleen worden verlaagd voor het exacte model en de methode die die limiet naleven, en alleen tot een betaalbare omvang die 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 al bekend daadwerkelijk verbruik. Voor nieuwe tekstverzoeken wordt een schatting gemaakt van de body en de bijlagen op basis van hun type. De berekening “4 tokens per byte, maar minimaal 4096 tokens” geldt voor eerder geaccepteerde reserveringen van de oude versie en beschrijft de nieuwe tekstreserveringen niet. Als een bijlage via een link is meegegeven (fileData) of ingebouwde tools zijn ingeschakeld, worden voor ondersteunde tekstverzoeken de bijlagen en het werk van de tools afzonderlijk geschat; de aanwezigheid ervan betekent op zichzelf niet dat het volledige invoervenster wordt gereserveerd. Voor eerdere reserveringen blijven de geaccepteerde voorwaarden gelden; voor media als output blijft de berekening van het volledige resultaat gelden.
  • Output wordt voor de reservering van een nieuw tekstverzoek geschat op basis van een typische antwoordlengte en de geaccepteerde voorwaarden. De gevraagde limiet wordt ingesteld via max_tokens (max_output_tokens bij Responses). De gevraagde limiet is niet automatisch gelijk aan het aantal tokens waarop de reservering is berekend en garandeert geen daadwerkelijke antwoordlengte bij een model zonder betrouwbare begrenzing. De standaardwaarde 4096 geldt alleen voor de bijbehorende routes; de precieze regel hangt af van het model en de methode.
  • Prijs houdt voor nieuwe tekstreserveringen, binnen de voorwaarden van dit verzoek, rekening met de standaard- of prioriteitsmodus en de prijsniveaus die bij de invoerschatting kunnen worden bereikt. Binnen de gekozen voorwaarden blijft de berekening conservatief; de flex-modus verlaagt de reservering niet. Bij een prioriteitsverzoek kan de reservering rekening houden met de duurste toepasselijke modus, waaronder priority, flex of fast. Eerder geaccepteerde reserveringen zonder deze voorwaarden behouden de oorspronkelijke berekening tegen de hoogste tarieven.
  • De limiet verlagen — wanneer de berekende reservering niet past en het exacte model en de methode de antwoordlengte kunnen begrenzen: de beschikbare middelen moeten voldoende zijn voor de invoerschatting en de minimale outputomvang. De verlaagde limiet komt niet onder 256 tokens (1025 met redeneren in het Anthropic-formaat). Het model ontvangt de 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 het getoonde rekenvoorbeeld zijn de daadwerkelijke kosten $0.0520. De getoonde afschrijving veronderstelt dat de geaccepteerde reservering en het beschikbare vrije saldo deze kosten dekken. De reservering wordt hier niet berekend: voor een nieuw tekstverzoek wordt die afzonderlijk bepaald op basis van een schatting van de invoer en een typisch antwoord en kan ze hoger of lager zijn dan de daadwerkelijke kosten. De ongebruikte reservering wordt vrijgegeven; de begrenzing van de afschrijving staat in de formule hieronder.

Daadwerkelijke afschrijving = min(volledige werkelijke kosten, geaccepteerde reservering + vrij niet-gereserveerd saldo). Andere openstaande reserveringen blijven beschermd; het totale saldo wordt dus niet noodzakelijk nul. Het saldo wordt niet negatief. Zijn de daadwerkelijke kosten hoger dan de geaccepteerde reservering plus het vrije, niet-gereserveerde saldo, dan blijft het ongedekte verschil een verlies voor Ailoot: het 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 antwoordreservering berekend op basis van een typische antwoordlengte, rekening houdend met de opgegeven max_tokens en de voorwaarden van het exacte model. Dit is een schatting voor de reservering, geen garantie voor de daadwerkelijke lengte of kosten van het antwoord.
  • Bij modellen zonder betrouwbare begrenzing van het daadwerkelijke antwoord wordt de schatting voor de reservering geen lengtelimiet. Voor nieuwe tekstverzoeken wordt die schatting niet automatisch vervangen door de kosten van het langst mogelijke antwoord. Eerder geaccepteerde 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