Häufige Fehlercodes

Wenn ein Statuscode auftritt, bestimmen Sie zuerst den Problemtyp und prüfen Sie dann nach Priorität

Viele vermuten bei einer Fehlermeldung sofort ein Problem mit der Plattform. Tatsächlich lassen sich die meisten Fehler bei der MoleAPI-Integration jedoch schnell über Statuscode + Konfiguration eingrenzen.

Empfohlene Vorgehensweise bei der Fehleranalyse

Verwerfen Sie nicht sofort die gesamte Konfiguration. Es empfiehlt sich, in dieser Reihenfolge vorzugehen:

Prüfen Sie zuerst den Statuscode.
Bestimmen Sie dann, ob es sich um ein Identitäts-, Berechtigungs-, Adress- oder Request-Inhaltsproblem handelt.
Prüfen Sie anschließend die entsprechende Konfiguration in der Konsole.

Fehlercode-Schnellübersicht

Statuscode	Häufige Bedeutung	Was Sie zuerst prüfen sollten
400	Fehlerhafte Request-Parameter	JSON-Struktur, Feldtypen, ob das Modell diesen Parameter unterstützt
401	Authentifizierung fehlgeschlagen	Ob der API Key korrekt ist, ob zusätzliche Leerzeichen vorhanden sind, ob er abgelaufen ist
403	Unzureichende Berechtigungen	Modellberechtigungen, Group, IP-Allowlist, Key-Limit
404	Fehlerhafte Adresse oder fehlerhaftes Routing	Ob die Base URL korrekt ist, ob `/v1` fehlt, ob der Pfad falsch geschrieben ist
429	Rate Limit oder Quota-Problem	Ob Request-Frequenz, Parallelität, Guthaben, Quota oder Limits ausgelöst wurden
500	Serverseitige Ausnahme	Zuerst Retry durchführen und Request-Informationen aufbewahren; bei fortlaufendem Auftreten den Support kontaktieren

Statuscodes im Detail

400: Problem mit dem Request selbst

Dieser Fehler bedeutet in der Regel:

Die Request-Struktur ist falsch.
Der Typ eines Felds ist falsch.
Sie übergeben dem Modell Parameter, die es nicht unterstützt.

Wenn Sie kürzlich das Modell oder SDK gewechselt oder Beispielcode von anderen übernommen haben, sollten Sie zuerst hier prüfen.

401: Problem mit dem API Key

Prüfen Sie vorrangig:

Ob Sie ein in der MoleAPI-Konsole erstelltes sk-... verwenden
Ob führende oder nachgestellte Leerzeichen vorhanden sind
Ob der Key unvollständig kopiert wurde
Ob versehentlich ein Key einer anderen Plattform verwendet wurde

403: Die API ist erreichbar, aber die Aktion ist nicht erlaubt

Dieser Fehler tritt am häufigsten auf, wenn:

der aktuelle Key keine Berechtigung für dieses Modell hat
die aktuelle Group dieses Modell nicht unterstützt
eine IP-Allowlist konfiguriert ist, die Quell-IP jedoch nicht übereinstimmt
das Quota oder ein Limit des Keys erreicht wurde

404: Falsche Adresse

Dies ist eines der häufigsten Probleme bei Einsteigern.

Prüfen Sie vorrangig:

Ob die Base URL als https://api.moleapi.com/v1 eingetragen ist
Ob noch gegen api.openai.com angefragt wird
Ob fälschlicherweise der vollständige Endpoint-Pfad als Base URL eingetragen wurde

429: Anfrage wurde begrenzt oder Quota reicht nicht aus

Wenn Sie 429 sehen, denken Sie nicht nur an „zu viele Requests in kurzer Zeit“, sondern prüfen Sie auch:

Ob das Guthaben ausreicht
Ob für den Key ein Limit gesetzt ist
Ob die Parallelität zu hoch ist
Ob in kurzer Zeit zu viele Requests gesendet wurden

500: Serverseitige Ausnahme

Wenn der Fehler nur gelegentlich auftritt, können Sie zunächst einen Retry versuchen. Wenn er stabil reproduzierbar ist, sollten Sie Folgendes festhalten:

Request-Zeitpunkt
Modellname
Request-Parameter
Request ID (falls auf Client-Seite vorhanden)

Damit lässt sich die weitere Analyse deutlich beschleunigen.

Eine sehr praktische Prüf-Reihenfolge

Wenn Sie nicht wissen, wo Sie anfangen sollen, sparen Sie mit dieser Reihenfolge am meisten Zeit:

Statuscode prüfen
Base URL prüfen
API Key prüfen
Modellname prüfen
Group / Berechtigungen / Limits prüfen
Guthaben und Logs prüfen

Faustregel

Bei 404 zuerst meist die Adresse prüfen; bei 401 meist zuerst den Key; bei 403 meist zuerst die Berechtigungen; bei 429 nicht nur die Frequenz, sondern auch Guthaben und Limits prüfen.