Skip to main content
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, 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 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 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 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.
Laatst gewijzigd op 10 augustus 2026