Fehlercode-Referenz

Fehlercode-Referenz

Wenn beim API-Aufruf oder bei der Website-Nutzung Fehler auftreten, schauen Sie hier nach.

401 Unauthorized

Bedeutung: ungültiger API-Key.

Prüfen:

  1. Ist der Key vollständig kopiert (beginnt mit sk-, keine Leerzeichen)
  2. Wurde der Key gelöscht? Unter API-Key-Verwaltung prüfen
  3. Ist die Umgebungsvariable aktiv? (Terminal neu öffnen)

403 Forbidden

Bedeutung: keine Berechtigung für die Ressource.

Prüfen: Key möglicherweise deaktiviert oder IP eingeschränkt. Key-Status unter API-Key-Verwaltung prüfen.

404 Not Found

Bedeutung: Modell nicht gefunden oder Pfad falsch.

Prüfen:

  1. Stimmt der Modellname exakt mit dem Modell-Marktplatz überein (Groß-/Kleinschreibung)
  2. Hat die Base URL das Suffix /v1

429 Too Many Requests

Bedeutung: zu viele Anfragen — Ratenbegrenzung ausgelöst.

Lösung: einige Sekunden warten und erneut versuchen; bei hoher Frequenz Wiederholungslogik im Code einbauen.

Saldo unzureichend

Bedeutung: Kontoguthaben reicht für diesen Aufruf nicht aus.

Lösung: auf der Aufladeseite aufladen.

500 / 502 / 503

Bedeutung: temporärer Serverfehler.

Lösung: später erneut versuchen. Bei anhaltenden Fehlern über Meine Formulare ein Ticket einreichen.