Doku
Abrechnung

Guthabenreservierung und Abbuchung

Markdown

So rechnet Ailoot ab: Reservierung vor der Anfrage, eine Abbuchung danach und ein Guthaben, das nie ins Minus fällt.

Kurz erklärt

  • Reservierung — vor dem Versand einer neuen Textanfrage reserviert Ailoot einen anhand der Eingabe und einer typischen Antwort geschätzten Betrag zu den akzeptierten Bedingungen der Anfrage. Für Bilder, Video und Audio als Ausgabe bleibt die vollständige Reservierung der Ergebniskosten bestehen.
  • Abbuchung — einmal nach dem tatsächlichen Verbrauch aus usage. Der ungenutzte Rest der Reservierung wird sofort freigegeben.
  • Wenn nicht einmal genügend Guthaben für die minimale Reservierung vorhanden ist — wird die Anfrage nicht an das Modell gesendet. Sie erhalten Fehler 402 mit verständlichem Text. Es wird nichts abgebucht.
Vollständiger Leitfaden

Kurz erklärt

  • Preis — in Dollar pro 1 Million Eingabe- und Ausgabetokens (oder pro Einheit: Bild, Videosekunde, Zeichen). Die Preise jedes Modells stehen im Katalog.
  • Reservierung — vor dem Versand einer neuen Textanfrage reserviert Ailoot einen anhand der Eingabe und einer typischen Antwort geschätzten Betrag zu den akzeptierten Bedingungen der Anfrage. Für Bilder, Video und Audio als Ausgabe bleibt die vollständige Reservierung der Ergebniskosten bestehen.
  • Niedrigeres Limit statt Ablehnung — passt die berechnete Reservierung nicht in das verfügbare Guthaben oder das Schlüssellimit, kann das Antwortlimit nur für das konkrete Modell und die Methode gesenkt werden, die es einhalten, und nur auf ein finanzierbares Volumen oberhalb oder auf Höhe des geltenden Minimums. Bei welchen Modellen dies funktioniert, steht weiter unten.
  • Abbuchung — einmal nach dem tatsächlichen Verbrauch aus usage. Der ungenutzte Rest der Reservierung wird sofort freigegeben.
  • Wenn die Antwort teurer ist als die Reservierung — wird die Differenz aus dem freien Guthaben genommen, das nicht durch andere Reservierungen gebunden ist. Die Abbuchung übersteigt niemals Ihr Guthaben; es fällt nicht ins Minus.
  • Wenn nicht einmal genügend Guthaben für die minimale Reservierung vorhanden ist — wird die Anfrage nicht an das Modell gesendet. Sie erhalten Fehler 402 mit verständlichem Text. Es wird nichts abgebucht.
  • Ein Fehler ohne Ergebnis wird nicht berechnet. Prüfen Sie nach einem Verbindungsabbruch die Anfrage anhand der Request ID im Verlauf des Kundenbereichs, bevor Sie sie erneut senden.

Berechnung der Reservierung

  • Eingabe wird anhand einer Schätzung der Anfragegröße und der unterstützten Anhänge reserviert, nicht anhand eines bereits bekannten tatsächlichen Verbrauchs. Für neue Textanfragen werden der Anfrageinhalt und die Anhänge ihrem Typ entsprechend geschätzt. Die Berechnung „4 Tokens pro Byte, mindestens aber 4096 Tokens“ gilt für bereits akzeptierte Reservierungen der alten Version und beschreibt keine neuen Textreservierungen. Wird ein Anhang als Link übergeben (fileData) oder sind integrierte Tools aktiviert, werden bei unterstützten Textanfragen Anhänge und Tool-Nutzung separat geschätzt; ihre bloße Verwendung bedeutet keine Reservierung des gesamten Eingabefensters. Für frühere Reservierungen gelten die akzeptierten Bedingungen weiter; bei Medienausgaben werden die Kosten des vollständigen Ergebnisses zugrunde gelegt.
  • Ausgabe wird für die Reservierung einer neuen Textanfrage anhand einer typischen Antwortlänge und der akzeptierten Bedingungen geschätzt. Das angeforderte Limit wird über max_tokens (max_output_tokens bei Responses) angegeben. Das angeforderte Limit entspricht nicht automatisch der Tokenzahl, auf deren Grundlage die Reservierung berechnet wird, und garantiert bei einem Modell ohne verlässliche Begrenzung keine tatsächliche Antwortlänge. Der Ausgangswert 4096 gilt nur für die entsprechenden Routen; die konkrete Regel hängt vom Modell und der Methode ab.
  • Preis berücksichtigt bei neuen Textreservierungen die Bedingungen der jeweiligen Anfrage: Standard- oder Prioritätsmodus sowie Preisstufen, die mit der Eingabeschätzung erreicht werden können. Innerhalb der gewählten Bedingungen bleibt die Berechnung konservativ; der flex-Modus verringert die Reservierung nicht. Bei einer Prioritätsanfrage kann die Reservierung den teuersten anwendbaren Modus berücksichtigen, einschließlich priority, flex oder fast. Bereits akzeptierte Reservierungen ohne diese Bedingungen behalten die ursprüngliche Berechnung zu den Höchstsätzen.
  • Reduzierung des Limits — wenn die berechnete Reservierung nicht gedeckt ist und das konkrete Modell und die Methode eine Begrenzung der Antwort erlauben: Die verfügbaren Mittel müssen die Eingabeschätzung und das minimale Ausgabevolumen decken. Das reduzierte Limit liegt nicht unter 256 Tokens (1025 mit Reasoning im Anthropic-Format). Das Modell erhält bereits das reduzierte Limit.

Berechnungsbeispiel

Modell claude-sonnet-5-5: Eingabe $2, Ausgabe $10 pro 1 Million Tokens. Sie haben 20 000 Tokens gesendet, das Modell hat mit 1 200 Tokens geantwortet.

SchrittBerechnungBetrag
Tatsächliche Eingabe20 000 × $2 / 1 000 000$0.0400
Tatsächliche Antwort1 200 × $10 / 1 000 000$0.0120
Abgebuchteine Abbuchung nach dem tatsächlichen Verbrauch$0.0520

Im gezeigten Rechenbeispiel betragen die tatsächlichen Kosten $0.0520. Die gezeigte Abbuchung setzt voraus, dass die akzeptierte Reservierung und das verfügbare freie Guthaben diese Kosten decken. Der Reservierungsbetrag wird hier nicht berechnet: Bei einer neuen Textanfrage wird er gesondert anhand einer Schätzung der Eingabe und einer typischen Antwort bestimmt und kann höher oder niedriger als die tatsächlichen Kosten sein. Die ungenutzte Reservierung wird freigegeben; die Begrenzung der Abbuchung steht in der folgenden Formel.

Tatsächliche Abbuchung = min(vollständige tatsächliche Kosten, akzeptierte Reservierung + freies nicht reserviertes Guthaben). Andere offene Reservierungen bleiben geschützt; deshalb muss das Gesamtguthaben nicht auf null sinken. Das Guthaben fällt nicht ins Minus. Übersteigen die tatsächlichen Kosten die akzeptierte Reservierung zuzüglich des freien, nicht reservierten Guthabens, bleibt die ungedeckte Differenz ein Verlust für Ailoot: Sie wird nicht zu Ihren Schulden und später nicht eingefordert.

Verbindungsabbruch beim Client

Das Schließen der Verbindung, ein Timeout Ihrer Anwendung oder die Weigerung, eine fertige Antwort zu lesen, brechen die Anfrage nicht automatisch ab: Die fertige Modellantwort wird einmal berechnet. Wird das Ergebnis durch Verschulden von Ailoot nicht geliefert, wird das Geld zurückerstattet. Prüfen Sie nach einem Verbindungsabbruch die Anfrage anhand der Request ID im Verlauf des Kundenbereichs, bevor Sie sie erneut senden.

Warum manchmal mehr Guthaben erforderlich ist

  • Bei neuen Textanfragen wird die Reservierung für die Antwort anhand einer typischen Antwortlänge berechnet, unter Berücksichtigung des angegebenen max_tokens und der Bedingungen des konkreten Modells. Dies ist eine Reservierungsschätzung, keine Garantie für die tatsächliche Länge oder die Kosten der Antwort.
  • Bei Modellen ohne verlässliche Begrenzung der tatsächlichen Antwort wird die Reservierungsschätzung nicht zu einer Längenbegrenzung. Für neue Textanfragen wird sie nicht automatisch durch die Kosten der längstmöglichen Antwort ersetzt. Bereits akzeptierte Reservierungen behalten ihre ursprünglichen Bedingungen.
  • Für Bilder in der Eingabe kommt eine Schätzung ihrer Kosten zur Reservierung hinzu.
  • Agenten wie Claude Code, Codex CLI und Cline senden in jedem Schritt einen großen Kontext. Ein einzelner Schritt kann eine Reservierung im zweistelligen Centbereich erfordern. Halten Sie mindestens einige Dollar Guthaben bereit.
  • Tipp: Wählen Sie einen angemessenen Wert für max_tokens — bei Modellen mit begrenzbarer Antwortlänge verringert dies die Reservierung.

Prompt-Cache

Bei Modellen mit Caching gelten separate Preise für das Schreiben in den Cache und das Lesen aus dem Cache. Lesen ist meist um ein Mehrfaches günstiger als gewöhnliche Eingabe. Die Preise stehen in der Modellkarte im Katalog.

Fehler 402

Reicht das freie Guthaben nicht einmal für die minimale Reservierung, 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 dieser Schuld ausgesetzt.

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

Wo Sie Ihre Kosten sehen

Anfragen und Abbuchungen finden Sie im Kundenbereich auf ailoot.ai. Für jede Anfrage sehen Sie Modell, Tokens und Betrag.

Noch Fragen? Senden Sie uns die Request ID und eine Beschreibung, damit wir Ihnen weiterhelfen können.Support kontaktieren