Startseite / Dokumentation / Anfragelimits

Anfragelimits

Wie die Drosselung funktioniert, was ein 429 hier bedeutet und wie Sie einen Client entwickeln, der keinen auslöst.

Limits sorgen für eine faire Verteilung der gemeinsam genutzten Upstream-Kapazität. Sie gelten pro Konto, nicht pro Schlüssel. Zusätzliche Schlüssel erhöhen Ihre Obergrenze daher nicht.

Was begrenzt wird

DimensionVerhalten
Gleichzeitige AnfragenLaufende Anfragen pro Konto. Die häufigste Ursache für einen 429.
Anfragen pro MinuteDauerhafte Aufrufrate.
Tokens pro MinuteGesamtdurchsatz für Eingabe und Ausgabe.

Tarife mit unbegrenzter Nutzung verwenden Fair-Use-Limits anstelle eines Guthabens — sie beseitigen die Gebühr pro Token, nicht die Obergrenze für gleichzeitige Anfragen.

Mit 429 richtig umgehen

  1. Verlängern Sie die Wartezeit exponentiell mit zufälliger Streuung — 1 s, 2 s, 4 s, 8 s, jeweils zuzüglich oder abzüglich eines zufälligen Anteils.
  2. Begrenzen Sie gleichzeitige Anfragen clientseitig mit einem Semaphor, statt alle auf einmal zu senden und abgewiesene Anfragen erneut zu versuchen.
  3. Stellen Sie Stapelverarbeitung in eine Warteschlange, statt sie maximal zu parallelisieren; der Durchsatz wird durch Tokens pro Minute begrenzt, nicht durch die Anzahl geöffneter Sockets.
  4. Behandeln Sie 529 anders als 429 — hier liegt die Ursache in der Upstream-Kapazität, nicht bei Ihnen, und das Problem behebt sich meist innerhalb von Sekunden.
import asyncio

sem = asyncio.Semaphore(8)      class=class="s">"c"># ceiling on concurrency, tune to your plan

async def ask(client, body):
    async with sem:
        return await client.post(class="s">"/v1/messages", json=body)
Agentenbasierte Tools wie Claude Code starten konstruktionsbedingt viele parallele Anfragen. Wenn bei intensiver Agentennutzung 429-Fehler auftreten, reduzieren Sie die Parallelität des Tools, bevor Sie zu einem höheren Tarif wechseln.

Die Last reduzieren statt Anfragen wiederholen