Rate-Limits

Jeder API-Key hat ein dauerhaftes Limit an Anfragen pro Sekunde, abgeleitet von deinem Tarif (Free 1 Anfrage/s → Max 60 Anfragen/s — siehe Preise). Limits werden mit einem Token-Bucket durchgesetzt: Bursts bis zu deiner Kapazität pro Minute sind erlaubt, danach werden Anfragen auf die dauerhafte Rate geglättet.

Wenn du limitiert bist

{ "error": "rate_limited", "retry_after_ms": 850 }

HTTP 429, error: "rate_limited".
retry_after_ms sagt dir die minimale Wartezeit vor einem erneuten Versuch.
Der x-ratelimit-remaining-Header bei jeder Antwort meldet, wie viele Anfragen diese Minute noch übrig sind.

Nebenläufigkeit

Über die Rate pro Sekunde hinaus gibt es eine Obergrenze für gleichzeitig laufende Anfragen. Wenn du viele Anfragen auf einmal abfeuerst, siehst du möglicherweise:

409 request_in_progress — eine identische idempotente Anfrage läuft bereits.
503 too_many_concurrent_requests — zu viele gleichzeitige Anfragen in Bearbeitung; fahre zurück und wiederhole.

Mit Limits umgehen

Respektiere retry_after_ms; andernfalls nutze exponentielles Backoff mit Jitter.
Halte eine clientseitige Nebenläufigkeitsgrenze passend zur Rate deines Tarifs.
Die offiziellen SDKs wiederholen 429/503 automatisch.