> ## 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.

# Veelvoorkomende foutcodes

Dit document vat de meest voorkomende foutcodes samen die door het Novita API-platform worden geretourneerd, inclusief definities, oorzaken en aanbevolen oplossingen om gebruikers te helpen efficiënt problemen op te lossen.

***

## Error Code 400

**Beschrijving**: Ongeldige aanvraagparameters.\
**Oplossing**:\
Bekijk de details van de foutmelding en controleer of de parameterindelingen, veldnamen of waardebereiken voldoen aan de API-documentatie.

***

## Error Code 401

**Beschrijving**: API Key ontbreekt of is onjuist.\
**Veelvoorkomende oorzaken**:

* **Ontbrekende sleutel**: geen `Authorization`-header, of de header heeft niet de vorm `Authorization: Bearer <API Key>`.
* **Verkeerde of onjuist gevormde sleutel**: een typefout, extra witruimte of een waarde die geen geldige `sk_`-sleutel is.
* **Verwijderde sleutel**: de sleutel is verwijderd in [Sleutelbeheer](https://novita.ai/settings/key-management), waardoor deze niet langer authenticeert.

**Oplossing**:

* Zorg ervoor dat de API Key in de aanvraag wordt meegegeven en het `Bearer`-schema gebruikt;
* Controleer of de API Key correct is en nog steeds bestaat in Sleutelbeheer;
* Als je omgevingsvariabelen of configuratiebestanden gebruikt, bevestig dan dat deze tijdens de uitvoering correct worden gelezen. Zie [API Keys](/docs/nl/guides/llm-api-keys) voor hoe je een sleutel opslaat en laadt.

***

## Error Code 403

**Beschrijving**: Toegang geweigerd vanwege onvoldoende machtigingen.

### Modeltoegang geweigerd (`model_access_denied`)

De API Key is geldig, maar mag het aangevraagde model niet aanroepen. De [modeltoegang](/docs/nl/guides/llm-model-access) van de sleutel is beperkt, en het aangevraagde model valt buiten het bereik ervan.

**Oplossing**:

* Roep een model aan dat binnen het toegangsbereik van de sleutel valt, of
* Vraag je teambeheerder om de [modeltoegang](/docs/nl/guides/llm-model-access) van de sleutel aan te passen zodat het model wordt opgenomen.

### Model vereist identiteitsverificatie

Sommige modellen vereisen identiteitsverificatie voordat je account er toegang toe kan krijgen.

**Oplossing**:

* Controleer of je account dat aan de API Key is gekoppeld toestemming heeft om toegang te krijgen tot het aangevraagde model;
* Log in op de console en controleer de verificatiestatus van je account;
* Als je nog niet bent geverifieerd, voltooi dan eerst de identiteitsverificatie;
* Gebruik eventueel een API Key van een account dat al is geverifieerd.

***

## Error Code 429

**Beschrijving**: Snelheidslimiet overschreden (Too Many Requests).\
**Oplossing**:

* Controleer of de limiet wordt veroorzaakt door **TPM** (tokens per minuut) of **RPM** (aanvragen per minuut);
* Raadpleeg de officiële documentatie over Rate Limits;
* Neem contact op met support of gebruik een geverifieerd account om je snelheidslimiet te verhogen.

***

## Error Code 503 / 504

**Beschrijving**: Backend-time-out of service niet beschikbaar, vaak veroorzaakt door hoge systeembelasting of throttling.

### Mogelijke oorzaken:

* Overbelasting van GPU of CPU op modelservicenodes;
* Lange generatietijd bij niet-streaming aanvragen overschrijdt de gateway-time-out;
* Storingen in downstreamservices (bijv. Redis, model engine);
* Traffic shaping-module heeft surge protection geactiveerd en 503 geretourneerd.

### Aanbevolen oplossingen:

**Voor API-gebruikers**:

* **Schakel een retry-mechanisme in**: Gebruik exponential backoff om herhaalde overbelasting te voorkomen;
* **Schakel over naar streamingmodus**: Streamingantwoorden retourneren tokens terwijl ze worden gegenereerd, waardoor latentie en het risico op time-outs afnemen;
* **Optimaliseer clientinstellingen**: Zorg ervoor dat `client_timeout` en `proxy_timeout` langer zijn dan 60 seconden;
* **Vermijd piekperioden**: Probeer bij scenario’s met hoge gelijktijdigheid opnieuw tijdens daluren.

**Voor Platform Ops**:

* Verbeter monitoring en autoscaling van modelservices;
* Pas `proxy_read_timeout` op gateway-niveau passend aan;
* Implementeer fijnmazige throttlingregels (bijv. prioriteitswachtrijen, prioritering van kernactiviteiten);
* Gebruik Prometheus + Alertmanager om waarschuwingen te activeren bij pieken in 503/504.

***

## Error Code 500

**Beschrijving**: Interne serverfout—meestal veroorzaakt door backend-excepties of crashes van de model engine.\
**Oplossing**:

* Deze problemen vereisen doorgaans een oplossing aan platformzijde. Neem contact op met support om logs en systeembronnen te onderzoeken;
* Probeer eventueel van model te wisselen of terug te vallen op een configuratie die minder resources vereist.

***

## Other Errors

Voor ongedefinieerde of ongedocumenteerde fouten:

* Raadpleeg eerst het veld `message` in de API-respons;
* Controleer vervolgens aanvraaglogs of consoletraces;
* Neem tot slot contact op met Novita-support of dien een ticket in voor verdere hulp.