> For the complete documentation index, see [llms.txt](https://docs.kontinent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kontinent.ai/documentation/dokumentation/features/rate-limits.md).

# 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.

| `429`-Code              | Wer hat ein Limit erreicht      | Was zu tun ist                                          |
| ----------------------- | ------------------------------- | ------------------------------------------------------- |
| `rate_limit_exceeded`   | Das RPM Ihres Schlüssels        | Backoff; das gleitende Fenster beträgt 60 s.            |
| `upstream_rate_limited` | Ein Anbieter hat uns gedrosselt | Erneut versuchen mit exponentiellem Backoff und Jitter. |

## Guthaben

Kontinent ist **Prepaid**. Ihre Organisation hält ein Guthaben in [Mikro-EUR](/documentation/dokumentation/models-and-routing/models.md#preise-und-die-geldeinheit), und jede Anfrage bucht exakt die Kosten der verwendeten Tokens ab. Die Messung läuft asynchron abseits des Hot Path, sodass die Abrechnung Ihrer Anfrage nie Latenz hinzufügt.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><h4><i class="fa-coins" style="color:$primary;">:coins:</i></h4></td><td><strong>Zahlen pro Token</strong></td><td>Abgerechnet nach tatsächlicher Nutzung, abgeglichen mit einem Append-only-Ledger.</td></tr><tr><td><h4><i class="fa-receipt" style="color:$primary;">:receipt:</i></h4></td><td><strong>Kein versteckter Overhead</strong></td><td>Nur Metadaten: Token-Anzahl, Latenz, Status, Modell und Kosten. Nicht mehr.</td></tr></tbody></table>

* 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.

{% hint style="info" %}
`402 insufficient_credits` kann **nach** dem Aufladen sicher erneut versucht werden. Bis dahin schlägt ein erneuter Versuch ohne zusätzliches Guthaben weiterhin fehl.
{% endhint %}

## Verwandte Seiten

{% content-ref url="/pages/7R1ViKCJpzbvV0OeM7nk" %}
[Fehler behandeln](/documentation/dokumentation/features/errors.md)
{% endcontent-ref %}

{% content-ref url="/pages/LPSVNkKoP0HQfECoQl3y" %}
[Modelle & Souveränität](/documentation/dokumentation/models-and-routing/models.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.kontinent.ai/documentation/dokumentation/features/rate-limits.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
