API: Fehler, Status-Codes & Limits
Vollständige Referenz der HTTP-Status-Codes, des OpenAI-kompatiblen Fehlerformats, der Budget- und Größenlimits der öffentlichen Kasimir-API.
Die Kasimir-API ist OpenAI-kompatibel: Fehler kommen im selben JSON-Format wie bei OpenAI zurück, sodass gängige OpenAI-SDKs sie wie gewohnt als Fehler melden. Diese Seite beschreibt die Status-Codes, das Fehlerobjekt und die Grenzen, die für Anfragen gelten.
Fehlerformat
{
"error": {
"message": "Model \"foo\" not found",
"type": "not_found_error",
"code": null
}
}Feld | Inhalt |
|---|---|
message | Lesbare Beschreibung des Fehlers |
type | Fehlerart, abgeleitet aus dem Status-Code (siehe unten) |
code | Derzeit immer null |
Streaming: Tritt ein Fehler erst auf, nachdem der Stream begonnen hat, bricht der Stream ab. Behandle einen unerwartet endenden Stream in deinem Client als Fehler.
Status-Codes
Status | type | Bedeutung | Was tun? |
|---|---|---|---|
400 | invalid_request_error | Anfrage ungültig, z. B. fehlt model, messages oder input. | Anfrage korrigieren; ein erneuter Versuch ändert nichts. |
401 | authentication_error | Schlüssel fehlt, ist ungültig oder wurde widerrufen. | Schlüssel prüfen bzw. neu erstellen. |
402 | insufficient_quota | Das Monatsbudget eurer Firma ist aufgebraucht. | Budget unter Administration → Verbrauch & Abrechnung anheben oder bis zum Monatswechsel warten. |
403 | permission_error | Dem Schlüssel fehlt ein nötiger Scope, das Modell ist für eure Firma deaktiviert oder nicht freigegeben (z. B. ein Nicht-EU-Modell oder ein Modell, das euer Tarif nicht enthält), oder eure Firma ist gesperrt. | Scope bzw. Modellfreigabe von Owner oder Admin klären lassen. |
404 | not_found_error | Modell oder Agent nicht gefunden bzw. für eure Firma nicht verfügbar. | Modell-Slug mit GET /v1/models abgleichen; Agent-ID prüfen. |
429 | invalid_request_error | Zu viele Anfragen in kurzer Zeit mit diesem Schlüssel, oder das Modell ist gerade ausgelastet. | Kurz warten und mit Backoff erneut versuchen. |
5xx | api_error | Vorübergehender Fehler bei der Verarbeitung. | Mit Backoff erneut versuchen. 503 bedeutet: Das Budget konnte gerade nicht geprüft werden – kurz danach erneut senden. |
402 heißt nicht „diese Anfrage ist zu teuer“, sondern „das Monatsbudget der Firma ist erreicht“. Es zählt alle KI-Nutzung eurer Firma im laufenden Kalendermonat – über die API und in der App.
Grenzen
Grenze | Wert | Gilt für |
|---|---|---|
Monatsbudget | wie unter Administration → Verbrauch & Abrechnung eingestellt; ohne Budget unbegrenzt | alle Endpunkte |
messages | mindestens 1 Nachricht | /v1/chat/completions |
n | 1 bis 8 | /v1/chat/completions |
messages | 1 bis 50 Nachrichten | /v1/assistants/{id}/run |
temperature | 0 bis 2 | /v1/assistants/{id}/run |
max_tokens | 1 bis 32.000 | /v1/assistants/{id}/run |
/v1/chat/completions reicht die Parameter der OpenAI-Chat-API (z. B. temperature, max_tokens, tools oder response_format) an das Modell weiter; andere Felder ignoriert die API. Akzeptiert das Modell einen Wert nicht, kommt dessen Statuscode zurück, als Meldung aber nur ein allgemeiner Hinweis statt der Fehlermeldung des Modells.
In SDKs
Weil das Fehlerformat OpenAI-konform ist, erkennt jedes OpenAI-SDK diese Fälle: Das Python-SDK meldet z. B. AuthenticationError (401), PermissionDeniedError (403), NotFoundError (404), RateLimitError (429) und APIStatusError (5xx). Den konkreten Grund liest du aus error.message.