Rate Limits
Gemeinsamer Token Bucket, Antwort-Header und Umgang mit 429.
Die standardmäßige Schutzschwelle der öffentlichen API beträgt 1.000 Anfragen je 10 Sekunden und Konto (etwa 100 RPS dauerhaft). Sie ist eine hoch angesetzte Sicherung gegen Missbrauch und außer Kontrolle geratene Clients, kein niedriges Kontingent für normalen bezahlten Traffic. Zusätzliche Schlüssel erhöhen sie nicht.
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 7
Retry-After: 2Gemeinsamer Token Bucket
Alle Endpunkte unter /api/v1 verbrauchen denselben open_api-Bucket. Seine Kapazität ist 1.000, die Auffüllrate ungefähr 100 Token pro Sekunde. Für upload-url gilt zusätzlich eine separate hoch angesetzte Sicherung von 1.000 je 10 Sekunden. Für usage gilt eine deutlich engere separate Grenze von 30 Anfragen pro Minute; sie lässt auch dann nichts durch, wenn die Rate-Limit-Entscheidung nicht verfügbar ist, sondern antwortet mit 429.
Antwort-Header
Beobachten Sie X-RateLimit-Limit und X-RateLimit-Remaining. Bei HTTP 429 warten Sie die in Retry-After angegebene Sekundenzahl. Überzählige Anfragen werden sofort abgewiesen und nicht eingereiht.
Nicht mit Parallelität verwechseln
Das Rate Limit steuert die Einreichungsrate, nicht die Anzahl laufender Tasks. Guthaben, Ausgabenlimits und die Ausführungskapazität des Modells melden sich getrennt als 40201, 40202 und 50301. Webhooks vermeiden, dass Polling den Bucket aufbraucht.
Die vollständigen Felddefinitionen stehen im OpenAPI-3.1-Vertrag.