Überblick
Ein API-Abrechnungs- oder Kontingentfehler kann bedeuten, dass du ein genehmigtes Nutzungslimit oder ein konfiguriertes Ausgabenlimit erreicht oder deine Prepaid-Credits aufgebraucht hast. Prüfe den Fehler, bevor du deine Einstellungen änderst.
Fehler ermitteln
Prüfe error.code in der API-Antwort. Bei einem abrechnungsbezogenen Fehler kann für error.type weiterhin der allgemeinere Wert insufficient_quota verwendet werden.
| Fehlercode | Bedeutung | Nächster Schritt |
| organization_usage_limit_exceeded | Deine Organisation hat das von OpenAI genehmigte Nutzungslimit erreicht. | Prüfe das genehmigte Limit und die Möglichkeiten für eine Erhöhung. |
| organization_spend_limit_exceeded | Deine Organisation hat ein konfiguriertes festes Ausgabenlimit erreicht. | Prüfe die Ausgabenkontrollen der Organisation. |
| project_spend_limit_exceeded | Dein Projekt hat ein konfiguriertes festes Ausgabenlimit erreicht. | Prüfe die Ausgabenkontrollen dieses Projekts. |
| credit_balance_exhausted | Deine Organisation hat keine Prepaid-Credits mehr. | Lade dein API-Guthaben mit Credits auf. |
Ein erneuter Versuch stellt den Zugriff bei diesen Fehlern nicht wieder her, solange die betreffenden Credits oder Limits nicht angepasst wurden. Weitere Informationen findest du im Leitfaden zu API-Fehlercodes.
Prüfe dein genehmigtes Nutzungslimit
Rufe die Seite Limits deiner Organisation auf, um ihr aktuell genehmigtes monatliches Nutzungslimit und ihre Nutzungsstufe zu prüfen.
Die kostenpflichtigen API-Nutzungsstufen heißen Build, Launch und Grow. Deine Organisation steigt automatisch in diese Stufen auf, sobald ihre gesamten Käufe von Credits jeweils 5 USD, 100 USD und 500 USD erreichen. Höhere Stufen bieten in der Regel höhere Ratenlimits. Auf der Seite „Limits“ deiner Organisation findest du ihre aktuelle Stufe und ihre Limits.
Bestehende Organisationen mit kostenpflichtiger Nutzung wechseln automatisch von den Stufen 1–2 zu Build, von den Stufen 3–4 zu Launch und von Stufe 5 zu Grow. Für diese Umstellung ist keine zusätzliche Zahlung erforderlich. Die API-Preise und benutzerdefinierten Ratenlimits bleiben unverändert.
Details zu den Stufen findest du im Leitfaden zu API-Ratenlimits.
Konfigurierte Ausgabenkontrollen prüfen
Ausgabenwarnungen senden Benachrichtigungen, ohne den API-Datenverkehr zu stoppen. Feste Ausgabenlimits können betroffene Anfragen stoppen, sobald die erfassten Ausgaben den konfigurierten Betrag erreichen.
Es können sowohl Organisations- als auch Projektlimits gelten. Ein Organisationslimit gilt für die zugehörigen Projekte. Ein Projektlimit gilt für den diesem Projekt in Rechnung gestellten Datenverkehr. Diese Kontrollen sind von deinem durch OpenAI genehmigten Nutzungslimit unabhängig.
Wenn ein festes Limit den Fehler verursacht hat, kann eine Person mit der Berechtigung zur Verwaltung der entsprechenden Einstellungen das Limit erhöhen oder entfernen, sofern die Ausgaben fortgesetzt werden sollen. Andernfalls wird es mit dem nächsten Monatszyklus zurückgesetzt. Änderungen und ihre Durchsetzung erfolgen nicht sofort. Daher können die erfassten Ausgaben den konfigurierten Betrag geringfügig überschreiten.
Einstellungen und Anleitungen findest du im Leitfaden zu API-Ausgabenlimits.
Prepaid-Guthaben prüfen
Wenn deine Prepaid-Credits aufgebraucht sind, öffne das Portal für die API-Abrechnung und wähle je nach angezeigter Option Credits kaufen oder Credits-Guthaben aufladen, um weitere Credits zu kaufen. Es kann einige Minuten dauern, bis dein aktualisiertes Guthaben angezeigt wird.
Informationen zur Einrichtung und zum Aufladen findest du unter Prepaid-Abrechnung einrichten.
Prüfen, ob der Fehler auf ein Ratenlimit zurückzuführen ist
Ratenlimits für Anfragen und Token steuern, wie schnell du die API nutzen kannst. Sie unterscheiden sich von monatlichen Nutzungslimits, Ausgabenkontrollen und deinem Prepaid-Guthaben.
Informationen zu Ratenlimitfehlern bei Anfragen oder Token findest du unter Fehlerbehebung bei API-Ratenlimitfehlern.
Wenn das Problem weiterhin besteht
Vor der Eskalation
Halte die Fehlermeldung und den Fehlercode, den Zeitpunkt des Fehlers mit deiner Zeitzone sowie alle relevanten Anfrage-IDs bereit. Entferne vertrauliche Informationen aus Screenshots oder Code, die du weitergibst.
OpenAI-Support kontaktieren
Wenn dein Bedarf die für deine Organisation verfügbaren Limits übersteigt, du einen besonderen Anwendungsfall hast oder der Fehler nach Behebung seiner Ursache weiterhin auftritt, kontaktiere den OpenAI-Support über das Chat-Widget im Hilfecenter.
Hinweise zur Kontaktaufnahme und zu den erforderlichen Angaben findest du unter Support kontaktieren.