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