Reservierung und Abbuchung
MarkdownSo berechnet Ailoot die Kosten: Reservierung vor der Anfrage, eine Abbuchung danach und ein Guthaben, das nie negativ wird.
Kurz erklärt
- Reservierung — vor dem Senden einer neuen Textanfrage reserviert Ailoot die geschätzten Kosten für Eingabe und eine typische Antwort zu den für die Anfrage akzeptierten Bedingungen. Bei Bildern, Video und Audio als Ausgabe bleibt die vollständige Reservierung der Ergebniskosten bestehen.
- Abbuchung — einmalig, anhand des tatsächlichen Verbrauchs aus
usage. Der übrige reservierte Betrag wird sofort freigegeben. - Wenn das Guthaben nicht einmal für die Mindestreservierung reicht — wird die Anfrage nicht an das Modell gesendet. Sie erhalten den Fehler 402 mit einem verständlichen Text. Es wird nichts abgebucht.
Vollständiger Leitfaden
Kurz erklärt
- Preis — in Dollar pro 1 Mio. Eingabe- und Ausgabetokens (oder pro Einheit: Bild, Videosekunde, Zeichen). Die Preise jedes Modells stehen im Katalog.
- Reservierung — vor dem Senden einer neuen Textanfrage reserviert Ailoot die geschätzten Kosten für Eingabe und eine typische Antwort zu den für die Anfrage akzeptierten Bedingungen. Bei Bildern, Video und Audio als Ausgabe bleibt die vollständige Reservierung der Ergebniskosten bestehen.
- Niedrigeres Limit statt Ablehnung — wenn die berechnete Reservierung nicht in das frei verfügbare Guthaben oder das Schlüssellimit passt, darf das Antwortlimit nur bei genau dem Modell und der Methode reduziert werden, die es einhalten, und nur auf einen bezahlbaren Umfang, der das geltende Minimum nicht unterschreitet. Für welche Modelle das funktioniert — weiter unten.
- Abbuchung — einmalig, anhand des tatsächlichen Verbrauchs aus
usage. Der übrige reservierte Betrag wird sofort freigegeben. - Wenn die Antwort mehr kostet als reserviert — wird die Differenz aus dem frei verfügbaren Guthaben gedeckt, das nicht für andere Anfragen reserviert ist. Die Abbuchung übersteigt nie Ihr Guthaben: Es wird nicht negativ.
- Wenn das Guthaben nicht einmal für die Mindestreservierung reicht — wird die Anfrage nicht an das Modell gesendet. Sie erhalten den Fehler 402 mit einem verständlichen Text. Es wird nichts abgebucht.
- Fehler ohne Ergebnis werden nicht berechnet. Prüfen Sie bei einem Verbindungsabbruch die Anfrage anhand der Request ID im Verlauf des Kundenbereichs, bevor Sie sie erneut senden.
So wird die Reservierung berechnet
- Eingabe wird anhand der geschätzten Grösse der Anfrage und der unterstützten Anhänge reserviert, nicht anhand eines bereits bekannten tatsächlichen Verbrauchs. Für neue Textanfragen werden Anfrageinhalt und Anhänge je nach Typ geschätzt. Die Berechnung «4 Tokens pro Byte, mindestens jedoch 4096 Tokens» gilt für bereits akzeptierte Reservierungen der alten Version und beschreibt keine neuen Textreservierungen. Wird ein Anhang als Link übermittelt (
fileData) oder sind integrierte Werkzeuge aktiviert, werden bei unterstützten Textanfragen Anhänge und die Arbeit der Werkzeuge separat geschätzt; ihr Vorhandensein allein bedeutet keine Reservierung des gesamten Eingabefensters. Für frühere Reservierungen bleiben die akzeptierten Bedingungen bestehen, für Medien als Ausgabe die Berechnung für das vollständige Ergebnis. - Ausgabe wird für die Reservierung einer neuen Textanfrage anhand einer typischen Antwortlänge und der akzeptierten Bedingungen geschätzt. Das angeforderte Limit definieren Sie über
max_tokens(max_output_tokensin Responses). Das angeforderte Limit entspricht nicht automatisch der Tokenzahl, anhand derer die Reservierung berechnet wurde, und garantiert bei einem Modell ohne zuverlässige Begrenzung nicht die tatsächliche Länge der Antwort. Der Ausgangswert 4096 gilt nur für die entsprechenden Routen; die konkrete Regel hängt vom Modell und von der Methode ab. - Preis berücksichtigt bei neuen Textreservierungen die Bedingungen dieser Anfrage: den Standard- oder Prioritätsmodus und die Preisstufen, die gemäss Eingabeschätzung erreichbar sind. Innerhalb der gewählten Bedingungen bleibt die Berechnung konservativ; der Modus flex verringert die Reservierung nicht. Bei einer Prioritätsanfrage kann die Reservierung den teuersten anwendbaren Modus berücksichtigen, einschliesslich priority, flex oder fast. Bereits akzeptierte Reservierungen ohne diese Bedingungen behalten ihre ursprüngliche Berechnung zu den Höchstsätzen.
- Limit reduzieren — wenn die berechnete Reservierung nicht passt und das genaue Modell sowie die Methode eine Begrenzung der Antwort ermöglichen: Die verfügbaren Mittel müssen die geschätzte Eingabe und den Mindestumfang der Ausgabe decken. Das reduzierte Limit unterschreitet 256 Tokens nicht (1025 — mit Reasoning im Anthropic-Format). Das Modell erhält das bereits reduzierte Limit.
Berechnungsbeispiel
Modell claude-sonnet-5-5: Eingabe $2, Ausgabe $10 pro 1 Mio. Tokens. Sie haben 20 000 Tokens gesendet; das Modell hat mit 1 200 Tokens geantwortet.
| Schritt | Berechnung | Betrag |
|---|---|---|
| Tatsächliche Eingabe | 20 000 × $2 / 1 000 000 | $0.0400 |
| Tatsächliche Antwort | 1 200 × $10 / 1 000 000 | $0.0120 |
| Abgebucht | eine Abbuchung nach tatsächlichem Verbrauch | $0.0520 |
Im gezeigten Rechenbeispiel betragen die tatsächlichen Kosten $0.0520. Die ausgewiesene Belastung setzt voraus, dass die akzeptierte Reservierung und das verfügbare freie Guthaben diese Kosten decken. Die Höhe der Reservierung wird hier nicht berechnet: Bei einer neuen Textanfrage wird sie separat anhand der geschätzten Eingabe und einer typischen Antwort bestimmt und kann höher oder tiefer als die tatsächlichen Kosten sein. Der nicht genutzte Teil der Reservierung wird freigegeben; die Begrenzung der Belastung steht in der Formel unten.
Tatsächliche Abbuchung = min(vollständige tatsächliche Kosten, akzeptierte Reservierung + freies nicht reserviertes Guthaben). Andere offene Reservierungen bleiben geschützt; das gesamte Guthaben wird deshalb nicht zwingend null. Das Guthaben wird nicht negativ. Übersteigen die tatsächlichen Kosten die akzeptierte Reservierung plus das freie, nicht reservierte Guthaben, bleibt die ungedeckte Differenz ein Verlust bei Ailoot: Sie schulden diesen Betrag nicht, und er wird später nicht eingefordert.
Client-Verbindung trennen
Das Schliessen der Verbindung, ein Timeout Ihrer Anwendung oder das Nichtlesen einer bereits fertigen Antwort bricht die Anfrage nicht automatisch ab: Eine fertige Modellantwort wird einmalig abgerechnet. Wird das Ergebnis durch einen Fehler von Ailoot nicht zugestellt, erhalten Sie Ihr Geld zurück. Prüfen Sie bei einem Verbindungsabbruch die Anfrage anhand der Request ID im Verlauf des Kundenbereichs, bevor Sie sie erneut senden.
Warum manchmal mehr Guthaben nötig ist
- Für neue Textanfragen wird die Reservierung für die Antwort anhand einer typischen Länge berechnet, unter Berücksichtigung des angegebenen Werts für
max_tokensund der Bedingungen des genauen Modells. Dies ist eine Schätzung der Reservierung, keine Garantie für die tatsächliche Länge oder die Kosten der Antwort. - Bei Modellen ohne zuverlässiges Limit für die tatsächliche Antwort wird die geschätzte Reservierung nicht zu einer Längenbegrenzung. Bei neuen Textanfragen wird sie nicht automatisch durch die Kosten der längstmöglichen Antwort ersetzt. Bereits akzeptierte Reservierungen behalten ihre ursprünglichen Bedingungen.
- Bilder in der Eingabe erhöhen die Reservierung um ihre geschätzten Kosten.
- Agenten (Claude Code, Codex CLI, Cline) senden bei jedem Schritt einen umfangreichen Kontext: Ein einziger Schritt kann mehrere Dutzend Cents reservieren. Halten Sie mindestens einige Dollar Guthaben bereit.
- Tipp: Wählen Sie einen sinnvollen Wert für
max_tokens— das senkt die Reservierung bei Modellen, deren Antwortlänge sich begrenzen lässt.
Prompt-Cache
Modelle mit Caching haben separate Preise für das Schreiben in den Cache und das Lesen daraus. Das Lesen ist meist um ein Mehrfaches günstiger als eine normale Eingabe. Die Preise stehen auf der Modellkarte im Katalog.
Fehler 402
Reicht das frei verfügbare Guthaben nicht einmal für die Mindestreservierung, sendet Ailoot die Anfrage nicht und antwortet mit 402 und dem Code insufficient_balance. Ist das gesamte Ausgabenlimit des Schlüssels ausgeschöpft, lautet der Code api_key_quota_exhausted. Besteht auf dem Konto eine Schuld aus einer angefochtenen Zahlung, lautet der Code payment_disputed: Neue Anfragen sind bis zur Begleichung ausgesetzt.
{
"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-…"
}
}Kosten einsehen
Den Verlauf Ihrer Anfragen und Abbuchungen finden Sie im Kundenbereich auf ailoot.ai. Zu jeder Anfrage sehen Sie Modell, Tokens und Betrag.