Überblick
Für die API-Nutzung gelten Ratenlimits. Diese Limits begrenzen Anfragen, Token oder andere Nutzungsarten innerhalb eines festgelegten Zeitraums.
Eine 429-Antwort kann auf ein vorübergehendes Ratenlimit, ein aufgebrauchtes Prepaid-Guthaben oder ein Ausgaben- oder Nutzungslimit hinweisen. Prüfe die Fehlerdetails, bevor du die Anfrage wiederholst oder deine Abrechnungseinstellungen änderst.
Die Ursache ermitteln
Lies die Fehlermeldung und, sofern vorhanden, den Wert von error.code. Bei abrechnungsbezogenen Fehlern kann error.type weiterhin den allgemeineren Wert insufficient_quota haben.
| Fehler oder Code | Bedeutung | Was du tun kannst |
| Ratenlimit für Anfragen oder Token erreicht | Die Anfragen überschreiten ein geltendes Ratenlimit. | Verteile Anfragen zeitlich und befolge die folgenden Hinweise zu Wiederholungsversuchen. |
| credit_balance_exhausted | Die Organisation hat keine Prepaid-Credits mehr. | Füge in deinen API-Abrechnungseinstellungen Credits hinzu. |
| organization_usage_limit_exceeded | Die Organisation hat das von OpenAI festgelegte Nutzungslimit erreicht. | Beantrage die Genehmigung eines höheren Nutzungslimits. |
| organization_spend_limit_exceeded | Die Organisation hat ihr technisch durchgesetztes Ausgabenlimit erreicht. | Erhöhe oder entferne das Limit oder warte, bis es zum nächsten Monat zurückgesetzt wird. |
| project_spend_limit_exceeded | Das Projekt hat sein technisch durchgesetztes Ausgabenlimit erreicht. | Erhöhe oder entferne das Projektlimit oder warte, bis es zum nächsten Monat zurückgesetzt wird. |
Bei einem Abrechnungs-, Ausgaben- oder Kontingentfehler stellen Wiederholungsversuche den Zugriff nicht wieder her. Behebe zuerst das gemeldete Problem mit dem Guthaben oder Limit. Es kann einige Zeit dauern, bis Änderungen an technisch durchgesetzten Ausgabenlimits wirksam werden.
Um ein Ausgabenlimit zu ändern, benötigst du die Berechtigung, die entsprechenden Organisations- oder Projekteinstellungen zu verwalten. Wenn du keinen Zugriff hast, wende dich an die Person, die diese Einstellungen verwaltet.
Informationen zum Kauf von Prepaid-Credits findest du im Artikel Prepaid-Abrechnung für die API einrichten und verwalten.
Informationen zu den verschiedenen Möglichkeiten der Ausgabenkontrolle findest du im Leitfaden zu API-Ausgabenlimits.
Die geltenden Ratenlimits prüfen
Öffne die Seite „Limits“ deiner Organisation, um ihre aktuelle Nutzungsstufe und ihre Limits zu prüfen.
Ratenlimits können auf Organisations- und Projektebene gelten. Sie sind keine Kontingente für einzelne Personen. Die Limits unterscheiden sich auch je nach Modell, und einige Modellfamilien teilen sich ein Limit.
Prüfe, welches Limit in der Fehlermeldung genannt wird. Für Anfragen pro Minute und Token pro Minute gelten beispielsweise separate Limits. Du kannst eines erreichen und gleichzeitig unter dem anderen bleiben.
API-Limits für die Bildgenerierung prüfen
Die API-Ratenlimits für die Bildgenerierung hängen vom Modell und deiner Nutzungsstufe ab. Wähle dein Modell auf der Modellübersicht aus, um seine Limits anzuzeigen.
Anweisungen zur Einrichtung findest du im Entwicklungsleitfaden zur Bildgenerierung. Mehr zu den Nutzungsstufen erfährst du im Leitfaden zu API-Ratenlimits.
Die von deiner Anfrage verwendete Organisation prüfen
Wenn du mehreren Organisationen angehörst, prüfe, ob deine Anfragen die vorgesehene Organisation und das vorgesehene Projekt verwenden.
Wenn dein API-Schlüssel eine Standardorganisation verwendet, prüfe deine Einstellung zur Standardorganisation. Für verschiedene Organisationen können unterschiedliche Abrechnungsvereinbarungen und Nutzungsstufen gelten.
Vorübergehende Ratenlimit-Fehler reduzieren
Anfragen zeitlich verteilen und Lastspitzen vermeiden
Verteile Anfragen über die Zeit, statt viele auf einmal zu senden.
Ratenlimits können auch für kürzere Zeiträume als das angezeigte Intervall durchgesetzt werden. Ein Limit von 60 Anfragen pro Minute kann beispielsweise auch für Zeiträume von einer Sekunde durchgesetzt werden. Eine kurze Lastspitze kann daher einen Fehler auslösen, selbst wenn deine durchschnittliche Nutzung unter dem Limit pro Minute zu liegen scheint.
Lange Prompts und unnötig hohe Obergrenzen für Ausgabe-Token können ebenfalls zu Fehlern beim Token-Ratenlimit beitragen.
Anfragen mit Verzögerung wiederholen
Bei vorübergehenden Ratenlimit-Fehlern:
Prüfe, ob ein Retry-After-Antwortheader vorhanden ist.
Wenn der Header eine gültige Wartezeit enthält, warte mindestens so lange, bevor du die Anfrage wiederholst.
Wenn der Header fehlt oder ungültig ist, nutze exponentielles Backoff mit Jitter: Erhöhe die Wartezeit nach jedem erfolglosen Versuch und füge eine kurze zufällige Verzögerung hinzu.
Begrenze sowohl die Anzahl der Wiederholungsversuche als auch die dafür aufgewendete Gesamtzeit.
Die offiziellen OpenAI-SDKs wiederholen Anfragen bei geeigneten Ratenlimit-Fehlern bereits automatisch und berücksichtigen Retry-After, sofern vorhanden. Berücksichtige diese Wiederholungsversuche, bevor du eine weitere Wiederholungsschleife hinzufügst.
Auch erfolglose Anfragen werden auf die Limits pro Minute angerechnet. Wenn du dieselbe Anfrage ständig erneut sendest, kann das Problem länger anhalten.
Hinweise zur Implementierung und Beispiele findest du im Leitfaden zu API-Ratenlimits. Prüfe jede Bibliothek von Drittanbietern für Wiederholungsversuche, bevor du sie in deiner Anwendung verwendest.
Die Länge von Prompts und Modellergebnissen prüfen
Entferne unnötige Anweisungen, wiederholten Kontext und Beispiele aus deinen Prompts. Teste den überarbeiteten Prompt, um zu prüfen, ob er weiterhin das benötigte Ergebnis liefert.
Verwende den Parameter für Ausgabe-Token, den dein Endpunkt und dein Modell unterstützen:
Chat Completions verwendet max_completion_tokens.
Responses verwendet max_output_tokens.
Setze die Obergrenze nicht wesentlich höher an, als es die Anfrage erfordert. Diese Parameter berücksichtigen sowohl Reasoning-Token als auch sichtbare Modellergebnisse. Plane daher bei einem Reasoning-Modell genügend Token für beides ein.
Deine Nutzungsstufe prüfen
Wenn weiterhin Fehler auftreten, nachdem du Lastspitzen reduziert und die Token-Nutzung geprüft hast, findest du auf deiner Seite „Limits“ die verfügbaren Möglichkeiten, deine Limits zu erhöhen.
Die kostenpflichtige Nutzungsstufe deiner Organisation wird automatisch angehoben, sobald ihre gesamten Käufe von Credits die Schwellenwerte für Build, Launch und Grow erreichen. Höhere Stufen bieten in der Regel höhere Ratenlimits. Die Voraussetzungen für die einzelnen Stufen findest du im Leitfaden zu API-Ratenlimits.
Dein genehmigtes monatliches Nutzungslimit ist von den Ratenlimits für Anfragen und Token unabhängig. Eine Erhöhung des einen Limits bestätigt nicht, dass sich auch die anderen geändert haben.
Wenn das Problem weiterhin besteht
Bevor du dich an den Support wendest
Halte die genaue Fehlermeldung, etwaige Fehlercodes, die zugehörigen Anfrage-IDs, den Fehlerzeitpunkt mit Zeitzone und das in deinem Konto angezeigte relevante Limit bereit. Notiere, welche Schritte du bereits ausprobiert hast.
Den OpenAI-Support kontaktieren
Kontaktiere den OpenAI-Support über das Hilfecenter, wenn du das Problem nach Prüfung des gemeldeten Limits nicht lösen kannst. Gib keine API-Schlüssel oder anderen geheimen Authentifizierungsdaten weiter.