Abrechnung

Laden Sie Ihr Wallet über Stripe auf → das Guthaben wird Ihrem Wallet gutgeschrieben → die Kosten jedes API-Aufrufs werden in Echtzeit abgezogen. Wenn Ihr Guthaben null erreicht, liefern Aufrufe 402 insufficient_quota, bis Sie erneut Guthaben aufladen.

Das Abrechnungsmodell

Für jeden Aufruf berechnet Kunavo die Kosten für den Nutzer als den höheren von zwei Beträgen:

• Katalogkosten – der auf der Modellkarte angezeigte Preis (pro 1M Token, pro Bild, pro Sekunde Video usw.) multipliziert mit den tatsächlich genutzten Einheiten.
• Kosten beim Upstream-Anbieter – der Betrag, den der Upstream-Anbieter Kunavo für den jeweiligen Aufruf berechnet hat, angegeben in Credits, wobei 1 Credit $0.005 entspricht.
• Aufschlagsfaktor — in der Regel 1.5 (50% Aufschlag auf die Kosten des vorgelagerten Anbieters). Bei einigen Modellen chinesischer Anbieter, deren vorgelagerter Großhandelspreis näher am offiziellen Preis des Anbieters liegt, wird der Faktor auf 1.2 reduziert, damit wir unter dem offiziellen Preis bleiben.

Die max()-Formel gewährleistet: (a) Sie zahlen nie weniger als den angegebenen Katalogpreis und (b) wir machen bei keinem Aufruf Verluste, wenn die Kosten beim Upstream-Anbieter unerwartet steigen.

Abrechnungseinheiten nach Modalität

Lange Prompts werden zum Langkontexttarif des Anbieters abgerechnet. Bei GPT-5.5, GPT-5.6 Sol und Terra sowie GPT-6 Astra wird eine Anfrage mit mehr als 272K Eingabe-Token vollständig mit 2× für die Eingabe abgerechnet – einschließlich Cache-Lese- und Schreibvorgängen – und mit 1.5× für die Ausgabe, entsprechend dem von OpenAI veröffentlichten Tarif. Für Claude gibt es keinen Langkontextaufschlag: Das Kontextfenster mit 1M Token wird zum Standardtarif abgerechnet.

Gecachte Token

Chatmodelle cachen stabile Prompt-Präfixe. Cache-Lesevorgänge werden deutlich günstiger als normale Eingaben abgerechnet – bei Claude und OpenAI jeweils zu 0.10×, und 0.025× on Claude Fable 5.1, 0.05× on Claude Opus 5.5. Cache-Schreibvorgänge werden bei allen Claude-Modellen zu 1.25× des Eingabepreises abgerechnet, auch Schreibvorgänge mit 1-Stunden-TTL (weniger als bei Anthropic: 2×), ebenso bei GPT-5.6 Sol, Terra und Luna sowie GPT-6 Astra. Bei allen anderen Modellen werden sie zum normalen Eingabepreis abgerechnet. Für jede Klasse gilt der jeweilige Rabatt des Modells. Daher gilt für die Cachepreise derselbe Rabatt gegenüber den jeweiligen Listenpreisen des Anbieters wie für die Ein- und Ausgabepreise. Die oben genannte max()-Untergrenze wird unter Berücksichtigung des Caches berechnet, sodass der Rabatt bei Ihnen ankommt und nicht durch den Katalogpreis aufgehoben wird.

Die Anleitung zum Prompt-Caching enthält die vollständige Preistabelle, erklärt, wie Sie cache_control aktivieren, und zeigt, wie Kunavos Affinitätsrouting den Cache warm hält.

Genauigkeit

Alle Beträge in Kunavo werden in micro_cents gespeichert:

• 1 USD = 100,000,000 micro_cents
• 1 cent = 1,000,000 micro_cents
• Kleinster abrechenbarer Betrag: 0.0001 cent ($0.000001). Viele übliche Chataufrufe werden mit diesem Mindestbetrag abgerechnet.

Die Anzeige im Dashboard rundet kleine USD-Beträge auf 6 Dezimalstellen und Beträge im Centbereich auf 2 Dezimalstellen. Die interne Buchführung erfolgt exakt.

Guthaben aufladen

Lade dein Guthaben unter /app/billing über Stripe Checkout auf: Karten (Visa, Mastercard, Amex, JCB, UnionPay), überall dort, wo Stripe verfügbar ist, sowie Apple Pay, Google Pay und Link überall außer in Indien. Länderspezifische Zahlungsmethoden werden für den jeweiligen Markt des Käufers angezeigt – in den Vereinigten Staaten Cash App Pay, Klarna, Afterpay, ACH-Lastschrift (Abwicklung innerhalb von 3–5 Werktagen) und Kryptowährungen (Stablecoins), außerdem Affirm bei Aufladungen ab $100 und Zip bei Aufladungen von $100 bis $1,500; Alipay und WeChat Pay für das chinesische Festland; KakaoPay, Naver Pay, PAYCO, Samsung Pay und koreanische Inlandskarten in Südkorea; UPI in Indien; Pix in Brasilien; iDEAL in den Niederlanden, Bancontact in Belgien, EPS in Österreich, MB WAY in Portugal und Satispay in Italien; BLIK in Polen; Bacs Direct Debit im Vereinigten Königreich; sowie Pay by Bank für Käufer im Vereinigten Königreich, in Irland und Finnland.

Tarifpreise

Automatisches Aufladen

Optional. Speichern Sie unter /app/billing einmalig eine Karte und legen Sie drei Werte fest: den Kontostand, unterhalb dessen aufgeladen werden soll, den Betrag jeder Aufladung und einen monatlichen Höchstbetrag. Anschließend lädt sich das Wallet selbst auf – innerhalb weniger Sekunden nach einer Abrechnung, durch die Ihr Kontostand unter den Schwellenwert fällt, und, falls in der Zwischenzeit eine Anfrage wegen unzureichenden Guthabens abgelehnt wird, bevor diese Anfrage beantwortet wird. So wird ein unbeaufsichtigter Agent nicht durch 402 gestoppt.

Solange eine Aufladung verarbeitet wird, erhält eine abgelehnte Anfrage 402 mit Retry-After: 3. Bei allen anderen Ablehnungen wird angegeben, was als Nächstes zu tun ist. Sie können die Funktion auf derselben Seite jederzeit deaktivieren oder die Werte ändern.

Zeitpunkt der Webhooks

Nachdem Sie Stripe Checkout abgeschlossen haben, wird Ihr Kontostand über einen Webhook aktualisiert. Der Webhook wird üblicherweise innerhalb von 5–10 Sekunden nach der Zahlungsbestätigung ausgelöst. Bei Kartenzahlungen geschieht dies nahezu sofort; bei Zahlungsmethoden, die erst asynchron bestätigt werden, kann die Abwicklung mehrere Tage dauern. Solche Bestellungen werden bis zum Eingang des Geldes als processing angezeigt. Der Webhook zur Abwicklungsbestätigung schreibt das Guthaben dann Ihrem Wallet gut – Sie müssen nicht erneut bezahlen, und in der Zwischenzeit verfällt nichts. Eine nie abgeschlossene Bestellung wird als pending angezeigt; unser Bereinigungsprozess ändert diese Kennzeichnung nach 24 Stunden in expired. Diese Kennzeichnung dient nur der Anzeige und storniert nichts.

Das Buchungsjournal

Jede Änderung des Kontostands wird in einem Journal mit ausschließlich angehängten Einträgen protokolliert:

In jeder Zeile wird balance_after_micro_cents festgehalten, sodass Sie eine Momentaufnahme des Kontostands nach jedem Ereignis erhalten. Den vollständigen Verlauf finden Sie unter /app/billing.

Nutzungsprotokolle

Für jeden API-Aufruf wird in usage_logs eine Zeile angelegt:

• Modell, Status (Erfolg / Fehler), HTTP-Statuscode
• Ein- / Ausgabetokens, Cache- und Cache-Schreib-Tokens, Bildanzahl, Sekunden, Zeichen
• upstream_cost_micro_cents — was Kunavo an den Upstream bezahlt hat
• cost_micro_cents — was Sie bezahlt haben (nach Aufschlag)
• Latenz, IP der Anfrage, User-Agent, Präfix des API-Schlüssels

Einsehbar unter /app/usage mit Filtern und Detailseiten für einzelne Aufrufe.

Fehlgeschlagene Aufrufe — kosten sie etwas?

Nein. Kunavo berechnet nur bei status = success Kosten. Wenn der Upstream 4xx / 5xx zurückgibt oder unsere Aufgabe das Zeitlimit überschreitet, wird der Aufruf protokolliert, aber die Kosten betragen $0. Wir übernehmen die Upstream-Kosten selbst, statt sie an Sie weiterzugeben.

Erstattungen

Erstattungen werden im Einzelfall über support@kunavo.com bearbeitet. In folgenden häufigen Fällen erstatten wir:

• Ein Ausfall auf Kunavos Seite, durch den Sie Guthaben verloren haben.
• Preisfehler, durch die Ihnen im Vergleich zum angezeigten Katalogpreis zu viel berechnet wurde.
• Versehentliches doppeltes Aufladen über Stripe.

Erstattungen erfolgen standardmäßig als Guthaben in Ihrem Wallet. Auf Anfrage sind auch Rückerstattungen auf ein Bankkonto über Stripe möglich.

Nächste Schritte

• Vollständige Preistabelle mit Rabatten gegenüber den offiziellen Preisen
• Fehlercodes (einschließlich Kontingent)
• Für die Claude API ohne Kreditkarte bezahlen