# Anfragelimits und gleichzeitige Aufgaben

Anfragelimits, Aufgabenlimits und Umgang mit 429.

Quelle: https://scifig.ai/de/docs/api/rate-limits

## Limits

| Limit | Wert | Gilt für |
| --- | --- | --- |
| Erstellungsanfragen | 20 pro Minute | Jeden API-Schlüssel bzw. jeden OAuth-Client und jedes Konto, über alle `POST`-Endpunkte hinweg |
| Erstellungsanfragen | 40 pro Minute | Jedes Konto, über alle seine Zugangsdaten hinweg |
| Leseanfragen | 120 pro Minute | Jeden API-Schlüssel bzw. jeden OAuth-Client und jedes Konto |
| Laufende Aufgaben | Je nach Tarif; siehe `GET /credits` | Jedes Konto, gemeinsam mit der Website |
| Aufgaben pro Stunde | 200 pro gleitender Stunde | Jedes Konto, gemeinsam mit der Website |
| Rasterkonvertierungen | 200 pro Tag | Jedes Konto |
| Texterkennungen | 20 pro 15 Minuten | Jedes Konto, gemeinsam mit der Website |
| Begrenzte Wartezeit | 30 Sekunden | Jede Anfrage |

## Umgang mit 429

- Antworten auf Anfragen, die Authentifizierung und Berechtigungsprüfung bestehen, enthalten `X-RateLimit-Limit`, `X-RateLimit-Remaining` und `X-RateLimit-Reset` für das strengste Anfragezeitfenster. Bei `401` und `403 SCOPE_DENIED` fehlen diese Header. Eine `429`-Antwort enthält `Retry-After` in Sekunden.
- `429 CONCURRENCY_LIMITED` bedeutet, dass für das Konto bereits zu viele Aufgaben laufen; abgeschlossene Aufgaben zählen nicht mehr. `429 RATE_LIMITED` hat die unten aufgeführten Ursachen.
- Warten Sie mindestens `Retry-After`, verlängern Sie die Abstände exponentiell mit zufälliger Streuung und wiederholen Sie die Anfrage mit demselben `Idempotency-Key`.
- Aufgabenlimits gelten für das Konto: Weitere Schlüssel erhöhen die Kapazität nicht.

## Ursachen für 429

- Zu viele Anfragen: 20 Erstellungsanfragen pro Minute und Zugangsdaten, 40 pro Konto, 120 Leseanfragen pro Minute und Zugangsdaten. `Retry-After` gibt die Zeit bis zum Zurücksetzen des Zeitfensters an; `details.reason` ist nicht vorhanden.
- In der letzten Stunde wurden zu viele Aufgaben gestartet: höchstens 200 pro Konto, gemeinsam mit der Website. `Retry-After: 30`.
- Zu viele Aufgaben laufen gleichzeitig: `429 CONCURRENCY_LIMITED`, je nach Tarif und gemeinsam mit der Website; siehe `GET /credits`. `Retry-After: 30`.
- Das Tageskontingent von 200 kostenlosen PNG-, PDF-, TIFF- und PPTX-Konvertierungen ist ausgeschöpft: `details.reason = DAILY_CONVERSION_LIMIT`, `Retry-After` bis zum Zurücksetzen des Tagesfensters.
- Uploads erfolgen zu schnell: `details.reason = UPLOAD_RATE_LIMITED` für Bilder und Masken an `POST /files`, Flussdiagrammanhänge und Diagrammdaten. Es gilt das Uploadlimit pro Minute der Website.
- Zu viele Uploads an einem Tag: `details.reason = UPLOAD_DAILY_LIMIT_REACHED` für Flussdiagrammanhänge und Diagrammdaten. Es gilt das tägliche Uploadlimit der Website.
- Texterkennungen: 20 je 15 Minuten und Konto, gemeinsam mit der Website.