> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Häufige Fehlercodes

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](https://novita.ai/settings/key-management) 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](/docs/de/guides/llm-api-keys) 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](/docs/de/guides/llm-model-access) 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](/docs/de/guides/llm-model-access) 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.