Verbrauch & Abrechnung

Der Verbrauch pro Anfrage steckt in jeder Antwort – rechnen Sie getrost danach ab. Das aktuelle Guthaben liefert GET /v1/dashboard/balance.

Verbrauch pro Anfrage

Jede Antwort von /v1/messages enthält ein usage-Objekt mit den Token-Zahlen:

{
"usage": {
"input_tokens": 48,
"output_tokens": 92,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0
}
}

Bei Chat Completions erscheinen dieselben Zahlen als prompt_tokens, completion_tokens und total_tokens.

Schlüsselguthaben: GET /v1/dashboard/balance

Liefert das aktuelle Guthaben des Schlüssels. Die Antwort kommt sofort, und es genügt derselbe Schlüssel wie für die API.

curl -H "Authorization: Bearer sk-YOUR_KEY_HERE" \
https://api.oneprovider.dev/v1/dashboard/balance

Antwort 200 OK:

{
"object": "balance",
"balance_usd": 54.77,
"expires_at": "2026-07-29T19:00:00Z",
"is_active": true,
"last_synced_at": "2026-06-29T19:52:00Z"
}

• balance_usd: das verfügbare Guthaben des Schlüssels in USD.
• expires_at: Ablauf des Schlüssels (ISO 8601 UTC, null, wenn keiner gesetzt ist).
• is_active: false, wenn der Schlüssel pausiert oder deaktiviert ist.
• last_synced_at: wann das Guthaben zuletzt aktualisiert wurde.

OpenAI-kompatible Guthaben-Endpoints

Apps wie NextChat und LobeChat lesen das Guthaben über Pfade im OpenAI-Stil. Diese funktionieren mit demselben Schlüssel in Authorization: Bearer:

Fehler: 401 bei fehlendem oder ungültigem Header Authorization: Bearer; 429, wenn Sie das Rate-Limit überschreiten (die Guthaben-Endpoints sind pro IP begrenzt). Guthaben und Ausgaben pro Anfrage stehen auch im Konto (Seite „Verbrauch“ im Bot @oneprovider_robot und auf app.oneprovider.dev ).

Effektive Preise

Wir rechnen zum festen Preis pro 1 Mio. Tokens ab, der auf /pricing steht. Es gibt keinen Faktor, kein Minimum und keine Rundung. Die Rechnung lautet:

cost = (input_tokens / 1_000_000) * rate_in
+ (output_tokens / 1_000_000) * rate_out
+ (cache_read_input_tokens / 1_000_000) * (rate_in * 0.10)
+ (cache_creation_input_tokens / 1_000_000) * (rate_in * 1.25)

• Cache-Lesezugriffe werden bei den meisten Modellen mit 10 % des Eingabepreises berechnet.
• Das Anlegen des Caches (wenn ein Cache-Breakpoint zum ersten Mal geschrieben wird) wird bei den meisten Modellen mit 125 % des Eingabepreises berechnet.
• Die Faktoren 0,10 und 1,25 in der Formel sind typische Werte: Die genauen Preise für Cache-Lesen und Cache-Schreiben jedes Modells stehen in der Modelltabelle .

Wenn das Guthaben aufgebraucht ist

Sobald das Guthaben des Schlüssels null erreicht, liefern Anfragen mit ihm 429 mit error.type insufficient_balance, error.code insufficient_quota und dem Header x-should-retry: false:

HTTP/1.1 429 Too Many Requests
x-should-retry: false
Content-Type: application/json
{
"type": "error",
"error": {
"type": "insufficient_balance",
"code": "insufficient_quota",
"message": "Insufficient balance on this API key. Top up: dashboard.oneprovider.dev"
}
}

Nicht erneut versuchen: Prüfen Sie das Guthaben des Kontos und das Limit des Schlüssels (Seite „Schlüssel“), laden Sie das Konto bei Bedarf auf und senden Sie die Anfrage erneut (so geht’s ). Alle übrigen Codes stehen unter Fehlercodes .

Rate-limit (429)

Zu viele Anfragen in kurzer Zeit liefern 429 rate_limit_error. Die Antwort kann einen Header Retry-After in Sekunden enthalten:

HTTP/1.1 429 Too Many Requests
Retry-After: 2
Content-Type: application/json
{
"type": "error",
"error": {
"type": "rate_limit_error",
"message": "Rate limit exceeded; retry later"
}
}

Ist Retry-After vorhanden, warten Sie mindestens so lange; sonst versuchen Sie es mit wachsender Pause erneut. Kommen weiter 429er, senken Sie die Parallelität im Client. Anfragen, die das Rate-Limit treffen, verbrauchen kein Guthaben.

Genauigkeit des Verbrauchs pro Anfrage

Die usage-Objekte der einzelnen Anfragen ergeben exakt die tatsächlichen Ausgaben pro Schlüssel. Geprüft am 08.05.2026 an einer 24-Stunden-Stichprobe von 25.845 Anfragen: Die maximale Abweichung lag unter 0,001 $ (Rundung an der 6. Nachkommastelle). Rechnen Sie getrost nach dem usage der einzelnen Anfragen ab.