Skip to main content
Dieses Dokument fasst die häufigsten Fehlercodes zusammen, die von der Novita API-Plattform zurückgegeben werden, zusammen mit Definitionen, Ursachen und empfohlenen Lösungen, um Benutzern eine effiziente Fehlerbehebung zu ermöglichen.

​
Fehlercode 400

Beschreibung: Ungültige Anfrageparameter.
Lösung:
Prüfen Sie die Details der Fehlermeldung und kontrollieren Sie, ob Parameterformate, Feldnamen oder Wertebereiche der API-Dokumentation entsprechen.

​
Fehlercode 401

Beschreibung: API-Key fehlt oder ist falsch.
Häufige Ursachen:
  • Fehlender Schlüssel: kein Authorization-Header, oder der Header hat nicht die Form Authorization: Bearer <API Key>.
  • Falscher oder fehlerhaft formatierter Schlüssel: ein Tippfehler, zusätzliche Leerzeichen oder ein Wert, der kein gültiger sk_-Schlüssel ist.
  • Gelöschter Schlüssel: Der Schlüssel wurde in der Schlüsselverwaltung gelöscht und kann daher nicht mehr authentifizieren.
Lösung:
  • Stellen Sie sicher, dass der API-Key in der Anfrage bereitgestellt wird und das Bearer-Schema verwendet;
  • Vergewissern Sie sich, dass der API-Key korrekt ist und weiterhin in der Schlüsselverwaltung existiert;
  • Wenn Sie Umgebungsvariablen oder Konfigurationsdateien verwenden, bestätigen Sie, dass diese während der Ausführung korrekt gelesen werden. Siehe API-Schlüssel zum Speichern und Laden eines Schlüssels.

​
Fehlercode 403

Beschreibung: Zugriff aufgrund unzureichender Berechtigungen verweigert.

​
Modellzugriff verweigert (model_access_denied)

Der API-Schlüssel ist gültig, darf das angeforderte Modell jedoch nicht aufrufen. Der Modellzugriff des Schlüssels ist eingeschränkt, und das angeforderte Modell liegt außerhalb seines Bereichs. Lösung:
  • Rufen Sie ein Modell auf, das innerhalb des Zugriffsbereichs des Schlüssels liegt, oder
  • Bitten Sie Ihren Team-Administrator, den Modellzugriff des Schlüssels so anzupassen, dass das Modell eingeschlossen ist.

​
Modell erfordert Identitätsverifizierung

Einige Modelle erfordern eine Identitätsverifizierung, bevor Ihr Konto darauf zugreifen kann. Lösung:
  • Vergewissern Sie sich, dass Ihr mit dem API-Key verknüpftes Konto die Berechtigung hat, auf das angeforderte Modell zuzugreifen;
  • Melden Sie sich in der Konsole an und prüfen Sie den Verifizierungsstatus Ihres Kontos;
  • Falls nicht verifiziert, schließen Sie zuerst die Identitätsverifizierung ab;
  • Alternativ können Sie einen API-Key von einem bereits verifizierten Konto verwenden.

​
Fehlercode 429

Beschreibung: Ratenlimit überschritten (Too Many Requests).
Lösung:
  • Prüfen Sie, ob das Limit auf TPM (tokens per minute) oder RPM (requests per minute) zurückzuführen ist;
  • Konsultieren Sie die offizielle Dokumentation zu Ratenlimits;
  • Um Ihr Ratenlimit zu erhöhen, kontaktieren Sie den Support oder verwenden Sie ein verifiziertes Konto.

​
Fehlercode 503 / 504

Beschreibung: Backend-Timeout oder Dienst nicht verfügbar, häufig verursacht durch hohe Systemlast oder Drosselung.

​
Mögliche Ursachen:

  • GPU- oder CPU-Überlastung auf Modell-Service-Knoten;
  • Lange Generierungszeit bei nicht-streaming Anfragen überschreitet das Gateway-Timeout;
  • Ausfälle in nachgelagerten Diensten (z. B. Redis, Modell-Engine);
  • Das Traffic-Shaping-Modul hat den Schutz vor Lastspitzen aktiviert und 503 zurückgegeben.

​
Empfohlene Lösungen:

Für API-Benutzer:
  • Retry-Mechanismus aktivieren: Verwenden Sie exponentielles Backoff, um wiederholte Überlastung zu verhindern;
  • In den Streaming-Modus wechseln: Streaming-Antworten geben Tokens zurück, während sie generiert werden, wodurch Latenz und Timeout-Risiko reduziert werden;
  • Client-Einstellungen optimieren: Stellen Sie sicher, dass client_timeout und proxy_timeout 60 Sekunden überschreiten;
  • Spitzenzeiten vermeiden: Wiederholen Sie bei Szenarien mit hoher Parallelität den Versuch außerhalb der Stoßzeiten.
Für Plattformbetrieb:
  • Verbessern Sie Monitoring und Auto-Scaling von Modell-Services;
  • Passen Sie proxy_read_timeout auf Gateway-Ebene angemessen an;
  • Implementieren Sie fein abgestufte Drosselungsregeln (z. B. Prioritätswarteschlangen, Priorisierung des Kerngeschäfts);
  • Verwenden Sie Prometheus + Alertmanager, um Warnungen bei Spitzen von 503/504 auszulösen.

​
Fehlercode 500

Beschreibung: Interner Serverfehler – typischerweise verursacht durch Backend-Ausnahmen oder Abstürze der Modell-Engine.
Lösung:
  • Diese Probleme erfordern in der Regel eine Lösung auf Plattformseite. Kontaktieren Sie den Support, um Logs und Systemressourcen untersuchen zu lassen;
  • Optional können Sie versuchen, Modelle zu wechseln oder auf eine weniger ressourcenintensive Konfiguration zurückzugreifen.

​
Andere Fehler

Für undefinierte oder nicht dokumentierte Fehler:
  • Ziehen Sie zuerst das Feld message in der API-Antwort heran;
  • Prüfen Sie als Nächstes Anfrage-Logs oder Konsolen-Traces;
  • Kontaktieren Sie schließlich den Novita-Support oder reichen Sie ein Ticket ein, um weitere Unterstützung zu erhalten.
Zuletzt geändert am 10. August 2026