LogoLogoAPI-Dokumentation
LogoLogoAPI-Dokumentation
Startseite
ÜberblickAuthentifizierung und IdempotenzBildgenerierungBildbearbeitungBildkonvertierungJobs und begrenztes WartenCreditsFehlerRatenbegrenzung und ParallelitätAPI-Changelog
API-Dokumentation

Ratenbegrenzung und Parallelität

Anfragelimits pro Schlüssel und Job-Limits pro Konto

Die Limits schützen die Verfügbarkeit des Dienstes und greifen, bevor teure Arbeit beginnt.

LimitAktueller Wert
Job-Erstellung10 Anfragen pro Minute je API-Schlüssel, über alle Erstellungs-Endpunkte hinweg
Authentifizierte Lesezugriffe120 Anfragen pro Minute je API-Schlüssel
Laufende Jobs8 Jobs im Status queued oder processing pro Konto
Batch-Größebis zu 4 Ausgaben pro Generierungs- oder Bearbeitungs-Job
Begrenztes Wartenbis zu 30 Sekunden

Wird ein Anfrage- oder Job-Limit überschritten, kommt HTTP 429 mit RATE_LIMIT_EXCEEDED. Verwenden Sie exponentielles Backoff mit Jitter und beachten Sie Retry-After, sofern vorhanden. Der Idempotency-Key muss beim Wiederholen derselben logischen Anfrage unverändert bleiben.

Das Limit für laufende Jobs gilt kontoweit, auch bei mehreren API-Schlüsseln. Abgeschlossene Jobs zählen nicht dazu.

Bei maximaler Batch-Größe können acht laufende Generierungs- oder Bearbeitungs-Jobs insgesamt bis zu 32 Ausgaben anfordern. Das ist eine Grenze für die Einreichungskapazität, keine Zusage, dass alle Ausgaben gleichzeitig laufen.

Fehler

Stabile Fehlerhüllen, Codes und HTTP-Status

API-Changelog

Versionierte Änderungen am öffentlichen Vertrag