Ü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.
Genehmigtes Nutzungslimit prüfen
Rufe die Seite Limits deiner Organisation auf, um das aktuell genehmigte monatliche Nutzungslimit und die Nutzungsstufe zu prüfen.
Wenn deine API-Ausgaben steigen, stuft OpenAI deine Organisation automatisch in höhere Nutzungsstufen ein. Dadurch erhöhen sich in der Regel die Ratenlimits für die meisten Modelle. Richte dich nach den für deine Organisation angezeigten Limits, statt davon auszugehen, dass jedes Konto dasselbe monatliche Kontingent hat.
Einzelheiten zu den Nutzungsstufen 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.