> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.kontinent.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.kontinent.ai/_mcp/server.

# Rate-Limits & Guthaben

## Rate-Limits

Jeder API-Schlüssel hat ein **RPM-Limit** (Requests pro Minute), das über ein
gleitendes Fenster aus zwei 1-Minuten-Buckets durchgesetzt wird. Ein
Überschreiten liefert `429` mit dem Code `rate_limit_exceeded` — mit Backoff
erneut versuchen.

Der Limiter ist **fail-open**: Hat der zugrunde liegende Speicher Probleme,
werden Anfragen nie blockiert. Sie werden nicht wegen eines Infrastruktur-
Aussetzers auf unserer Seite rate-limitiert.

Ein separates `429 upstream_rate_limited` bedeutet, dass der **Anbieter** uns
gedrosselt hat und nicht Ihr Schlüssel sein Limit erreicht hat. Mit Backoff
erneut versuchen.

## Guthaben

Kontinent ist **Prepaid**. Ihre Organisation hält ein Guthaben in
[Mikro-EUR](/models#preise-und-die-geldeinheit), und jede Anfrage belastet die
Kosten der verwendeten Tokens.

* Guthaben wird **optimistisch** gegen einen Hot-Balance geprüft, sodass eine
  kleine Überziehung (begrenzt durch Ihr RPM) bewusst möglich ist.
* Ein Hintergrund-Worker gleicht die Ausgaben innerhalb von etwa **60 Sekunden**
  ab. Ist eine Organisation erschöpft, erhalten weitere Anfragen ein hartes
  `402` (`insufficient_credits`), bis eine Aufladung eingeht.
* Eine Aufladung **hebt die Sperre sofort auf** — Sie warten nicht auf den
  nächsten Abgleichzyklus.

`402 insufficient_credits` kann **nach** dem Aufladen sicher erneut versucht
werden. Bis dahin schlägt ein erneuter Versuch ohne zusätzliches Guthaben
weiterhin fehl.