Ratenbegrenzungen
Ratenbegrenzungen werden pro authentifiziertem Konto durchgesetzt, basierend auf Ihrem API-Schlüssel – nicht pro IP-Adresse. Das bedeutet, dass derselbe Client, der die API von mehreren Maschinen/IPs aus aufruft, dennoch eine gemeinsame Grenze teilt, und verschiedene Kunden, die sich eine ausgehende IP teilen (z. B. hinter einem Unternehmensproxy), sich gegenseitig nicht beeinflussen.
Grenzen nach Endpunktkategorie
| Kategorie | Grenze | Endpunkte |
|---|---|---|
| Upload / Verarbeitung | 30 pro Minute | POST /documents, POST /batches/{batch_name}/process, POST /documents/{document_id}/bbox, PUT /batches/{batch_name}/webhook |
| Statusabfrage / Ergebnisse | 120 pro Minute | GET /documents/{document_id}, GET /batches, GET /batches/{batch_name}, GET /batches/{batch_name}/results, GET /documents/{document_id}/bbox, GET /documents/{document_id}/image, GET /account, GET /account/usage, Vorlagen-/Feld-Endpunkte |
| Export | 10 pro Minute, 60 pro Stunde | GET /batches/{batch_name}/export |
Dies sind die aktuellen Standardwerte und können im Laufe der Zeit angepasst werden. Die unten beschriebenen Antwort-Header geben stets die tatsächlich für den aufgerufenen Endpunkt geltenden Werte wieder. Orientieren Sie sich daher an den Headern und nicht an fest codierten Zahlen.
Response-Header
Jede ratenbegrenzte Antwort – erfolgreich oder nicht – enthält drei Header, die Ihren aktuellen Status anzeigen:
| Header | Bedeutung |
|---|---|
X-RateLimit-Limit | Die Gesamtzahl der im aktuellen Fenster erlaubten Anfragen. |
X-RateLimit-Remaining | Verbleibende Anfragen im aktuellen Fenster. |
X-RateLimit-Reset | Wann das aktuelle Fenster zurückgesetzt wird. |
Prüfen Sie X-RateLimit-Remaining proaktiv in einer Polling-Schleife und reduzieren Sie die Frequenz, bevor Sie Null erreichen, anstatt erst auf einen 429-Fehler zu reagieren.
Wenn Sie ein Limit überschreiten
Das Überschreiten eines Limits gibt HTTP 429 mit dem standardmäßigen v1-Fehlerformat zurück:
{
"error": {
"type": "rate_limit_error",
"code": "rate_limit_exceeded",
"message": "Zu viele Anfragen. Verlangsamen Sie und wiederholen Sie den Vorgang nach dem Zurücksetzen des Fensters.",
"doc_url": "https://imagetotable.ai/developers/guides/errors#rate_limit_exceeded"
}
}Wenn Sie den Batch-Status abfragen, bevorzugen Sie die Registrierung eines Webhooks gegenüber einer engen Polling-Schleife – dies eliminiert das Risiko, das Statusabfrage-Limit für diesen Anwendungsfall zu überschreiten.