Reservierung und Abbuchung

• Preis — in Dollar je 1 Mio. Eingabe- und Ausgabetokens (oder je Einheit: Bild, Videosekunde, Zeichen). Die Preise jedes Modells finden Sie im Katalog.
• Reservierung — vor dem Senden eines neuen Textrequests reserviert Ailoot die geschätzten Kosten für Eingabe und eine typische Antwort zu den für den Request akzeptierten Bedingungen. Bei Bildern, Video und Audio als Ausgabe bleibt die volle Reservierung der Ergebniskosten bestehen.
• Niedrigeres Limit statt Ablehnung — ist die berechnete Reservierung durch das verfügbare Guthaben oder das Schlüssellimit nicht gedeckt, lässt sich das Antwortlimit nur für ein konkretes Modell und eine konkrete Methode senken, die dieses Limit einhalten, und nur auf einen bezahlbaren Umfang, der das geltende Minimum nicht unterschreitet. Für welche Modelle dies gilt, steht weiter unten.
• Abbuchung — einmalig, nach dem tatsächlichen Verbrauch aus usage. Der Rest der Reservierung wird sofort freigegeben.
• Wenn die Antwort mehr kostet als reserviert — wird die Differenz aus dem freien Guthaben abgebucht, das nicht für andere Requests reserviert ist. Die Abbuchung übersteigt niemals Ihr Guthaben: Es wird nicht negativ.
• Wenn das Guthaben nicht einmal für die Mindestreservierung reicht — wird der Request nicht an das Modell gesendet; Sie erhalten Fehler 402 mit verständlichem Text. Es wird nichts abgebucht.
• Ein Fehler ohne Ergebnis wird nicht verrechnet. Bei einem Verbindungsabbruch prüfen Sie den Request anhand der Request ID im Verlauf des Kundenbereichs, bevor Sie ihn erneut senden.

• Eingabe wird anhand einer Schätzung der Request-Größe und der unterstützten Anhänge reserviert, nicht anhand eines bereits bekannten tatsächlichen Verbrauchs. Für neue Textrequests werden der Request-Body und die Anhänge je nach ihrem Typ geschätzt. Die Berechnung „4 Tokens je Byte, mindestens jedoch 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 Werkzeuge aktiviert, werden für unterstützte Textrequests Anhänge und Werkzeugnutzung gesondert geschätzt; allein ihr Vorhandensein führt nicht zur Reservierung des gesamten Eingabefensters. Für frühere Reservierungen bleiben die akzeptierten Bedingungen bestehen; bei Medienausgaben werden weiterhin die Kosten des vollständigen Ergebnisses berechnet.
• Ausgabe wird für die Reservierung eines neuen Textrequests anhand der typischen Antwortlänge und der akzeptierten Bedingungen geschätzt. Das angeforderte Limit definieren Sie mit max_tokens (max_output_tokens bei Responses). Das angeforderte Limit entspricht nicht automatisch der Tokenzahl, auf der die Reservierung beruht, und garantiert bei einem Modell ohne verlässliche Begrenzung keine bestimmte 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 wird für neue Textreservierungen unter Berücksichtigung der Bedingungen dieses Requests berechnet: Standard- oder Prioritätsmodus und die Preisstufen, die anhand der geschätzten Eingabe erreichbar sind. Innerhalb der gewählten Bedingungen bleibt die Berechnung konservativ; der Modus flex verringert die Reservierung nicht. Bei einem priorisierten Request 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 mit 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 für die geschätzte Eingabe und den Mindestumfang der Ausgabe reichen. Das reduzierte Limit fällt nicht unter 256 Tokens (1025 mit Reasoning im Anthropic-Format). Das Modell erhält bereits das reduzierte Limit.

Modell claude-sonnet-5-5: Eingabe $2, Ausgabe $10 je 1 Mio. Tokens. Sie senden 20 000 Tokens, das Modell antwortet mit 1 200 Tokens.

Im angeführten 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. Die Höhe der Reservierung wird hier nicht berechnet: Bei einem neuen Textrequest wird sie gesondert anhand der geschätzten Eingabe und einer typischen Antwort bestimmt und kann über oder unter den tatsächlichen Kosten liegen. Der nicht genutzte Teil der Reservierung wird freigegeben; die Obergrenze der Abbuchung steht in der nachstehenden Formel.

Tatsächliche Abbuchung = min(vollständige tatsächliche Kosten, akzeptierte Reservierung + freies nicht reserviertes Guthaben). Andere offene Reservierungen bleiben geschützt; deshalb sinkt das gesamte Guthaben nicht unbedingt auf null. Das Guthaben wird nicht negativ. Übersteigen die tatsächlichen Kosten die Summe aus der akzeptierten Reservierung und dem freien, nicht reservierten Guthaben, bleibt die ungedeckte Differenz ein Verlust von Ailoot: Für Sie entsteht daraus keine Zahlungsschuld, und die Differenz wird später nicht eingefordert.

Das Schließen der Verbindung, ein Timeout Ihrer Anwendung oder das Nichtabholen einer bereits fertigen Antwort storniert den Request nicht automatisch: Eine fertige Modellantwort wird einmal verrechnet. Wird das Ergebnis aufgrund eines Fehlers von Ailoot nicht ausgeliefert, erhalten Sie das Geld zurück. Bei einem Verbindungsabbruch prüfen Sie den Request anhand der Request ID im Verlauf des Kundenbereichs, bevor Sie ihn erneut senden.

• Für neue Textrequests wird die Antwortreservierung anhand einer typischen Länge berechnet, unter Berücksichtigung des angegebenen Werts für 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ässliches Limit für die tatsächliche Antwort wird aus der Reservierungsschätzung keine Längenbegrenzung. Für neue Textrequests wird sie nicht automatisch durch die Kosten der längstmöglichen Antwort ersetzt. Bereits akzeptierte Reservierungen behalten ihre ursprünglichen Bedingungen.
• Bei Bildern in der Eingabe wird deren geschätzter Preis zur Reservierung hinzugerechnet.
• Agenten (Claude Code, Codex CLI, Cline) senden bei jedem Schritt umfangreichen Kontext: Ein einzelner Schritt kann mehrere Zehn-Cent-Beträge reservieren. Halten Sie zumindest einige Dollar Guthaben bereit.
• Tipp: Wählen Sie einen angemessenen Wert für max_tokens — das verringert die Reservierung bei Modellen, deren Antwortlänge sich begrenzen lässt.

Bei Modellen mit Caching gelten getrennte Preise für das Schreiben in den Cache und das Lesen daraus. Lesen ist üblicherweise um ein Mehrfaches günstiger als normale Eingabe. Die Preise stehen auf der Modellkarte im Katalog.

Reicht das frei verfügbare Guthaben nicht einmal für die Mindestreservierung, sendet Ailoot den Request nicht und antwortet mit 402 sowie dem Code insufficient_balance. Ist das gesamte Ausgabenlimit des Schlüssels aufgebraucht, lautet der Code api_key_quota_exhausted. Besteht auf dem Konto eine Schuld aus einer angefochtenen Zahlung, lautet der Code payment_disputed: Neue Requests bleiben 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-…"
  }
}

Den Verlauf von Requests und Abbuchungen finden Sie im Kundenbereich auf ailoot.ai. Für jeden Request sehen Sie Modell, Tokens und Betrag.