# API-Ratenbegrenzungen — Drosselung pro Konto & Header

> v1-Ratenbegrenzungen gelten pro Konto, nicht pro IP-Adresse. Jede Antwort enthält die Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset, sodass Sie sich selbst drosseln können, bevor Sie einen HTTP 429 erhalten.

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:

```json
{
  "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](/developers/guides/webhooks) gegenüber einer engen Polling-Schleife – dies eliminiert das Risiko, das Statusabfrage-Limit für diesen Anwendungsfall zu überschreiten.

---

Source: https://imagetotable.ai/de/developers/guides/rate-limits