Source: https://ailoot.ai/docs/nl-be/errors/ Canonical: https://ailoot.ai/docs/nl-be/errors/ Language: nl-be [Hulp](https://ailoot.ai/docs/nl-be/) # Fouten en limieten [Markdown](https://ailoot.ai/docs/nl-be/errors/index.md) Antwoordcodes, hun betekenis en wat je moet doen. Alle fouten zijn JSON met een Request ID. ## [](https://ailoot.ai/docs/nl-be/errors/#format)Foutformaat De fout komt in het formaat van de API die je hebt aangeroepen: een object `error` voor OpenAI, `{"type": "error", "error": {...}}` voor Anthropic en `error` met de velden `status` en `details` voor Gemini. SDK’s herkennen ze daardoor als gewone API-fouten. - `error.code` en `error.reason` — de foutklasse uit de tabel hieronder; deze waarden zijn gelijk. `error.type` — de standaardwaarde van het formaat (bijvoorbeeld `invalid_request_error` of `server_error`). - `error.request_id` (bij Anthropic: `request_id` op het hoogste niveau), de header `X-Request-ID` en het einde van de berichttekst bevatten de verzoek-ID. - Bij Gemini staat de klasse in `error.details`: `ErrorInfo.reason` — dezelfde code in hoofdletters (bijvoorbeeld `MODEL_OVERLOADED`), `domain` — `ailoot.ai`; de verzoek-ID staat in `RequestInfo.requestId`. - In het Gemini-formaat worden een 5xx-fout die niet automatisch opnieuw mag worden verstuurd en `result_pending_check` teruggegeven met status 409 en `status` `ABORTED`: zo proberen Gemini SDK en CLI ze niet zelf opnieuw. De foutklasse staat in `ErrorInfo.reason` (bijvoorbeeld `MODEL_TIMEOUT` of `RESULT_PENDING_CHECK`). - Het OpenAI-antwoord bevat ook de velden `code` en `message` op het hoogste niveau, voor oudere clients. ```json { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: 3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6.", "param": null, "reason": "invalid_api_key", "request_id": "3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } ``` ```json { "type": "error", "error": { "type": "authentication_error", "code": "invalid_api_key", "reason": "invalid_api_key", "message": "… Nothing was charged. … Request ID: 94ed3e31-4373-41ce-bf8a-0d1ed3f7235e." }, "request_id": "94ed3e31-4373-41ce-bf8a-0d1ed3f7235e" } ``` ```json { "error": { "code": 401, "status": "UNAUTHENTICATED", "message": "The API key is not valid. Nothing was charged. … Request ID: e7aa743b-9d0d-4064-b206-2562609f545b.", "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "reason": "INVALID_API_KEY", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "e7aa743b-9d0d-4064-b206-2562609f545b" } }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "e7aa743b-9d0d-4064-b206-2562609f545b" } ] } } ``` ‘Nothing was charged’ betekent dat er niets is afgeschreven. Bij X-Should-Retry: false — probeer niet automatisch opnieuw en controleer eerst de Request ID in de geschiedenis. ## [](https://ailoot.ai/docs/nl-be/errors/#codes)Foutcodes | HTTP | Klasse (reason) | Wat er is gebeurd | Wat je moet doen | | --- | --- | --- | --- | | 400 | `invalid_request` | Ongeldig verzoek: verkeerde body of parameter; het model ondersteunt een veld, bijlage of tool in het verzoek niet; de sleutel is via het adres doorgegeven | Pas het verzoek aan op basis van de foutmelding: verwijder het niet-ondersteunde veld, de bijlage of de tool; geef de sleutel mee in een header. Afwijzing wegens een niet-ondersteund veld, bijlage of tool gebeurt vóór de reservering — er is niets afgeschreven | | 400 | `context_length_exceeded` | Het verzoek is langer dan de modelcontext | Kort de geschiedenis in of kies een model met een grotere context | | 400 | `content_policy_violation` | Het verzoek is afgewezen volgens de modelregels | Formuleer het verzoek anders | | 401 | `invalid_api_key` | De sleutel ontbreekt of is ongeldig | Controleer of de volledige sleutel is meegestuurd | | 401 | `api_key_disabled` | De sleutel is uitgeschakeld | Schakel de sleutel in of maak een nieuwe aan | | 402 | `insufficient_balance`, `insufficient_quota` | Onvoldoende vrij saldo voor zelfs de minimale reservering (`insufficient_quota` — hetzelfde geval in de vorm die OpenAI SDK gewend is) | Waardeer je saldo op of verlaag max\_tokens | | 402 | `api_key_quota_exhausted` | De totale bestedingslimiet van de sleutel is opgebruikt | Verhoog de sleutellimiet in het dashboard | | 402 | `payment_disputed` | Het account heeft een schuld door een betwiste betaling | Nieuwe verzoeken zijn opgeschort totdat de schuld is afgelost — neem contact op met support | | 403 | `api_key_expired` | De sleutel is verlopen | Maak een nieuwe sleutel aan | | 403 | `account_inactive` | Je account is uitgeschakeld | Neem contact op met support | | 403 | `permission_denied` | Dit verzoek is niet toegestaan voor de sleutel (bijvoorbeeld vanwege het IP-adres) | Controleer de beperkingen van de sleutel | | 404 | `model_not_found` | Dit model bestaat niet | Controleer de ID aan de hand van /v1/models | | 404 | `unsupported_endpoint` | Het model werkt niet in dit formaat | Kies een ander formaat of model | | 404 | `not_found` | Dit pad of object (bijvoorbeeld een taak) bestaat niet | Controleer het adres en de identificator | | 409 | `duplicate_request` | De bewerking met dezelfde idempotentiesleutel is al geaccepteerd en mogelijk voltooid | Controleer het resultaat van de eerste bewerking; verstuur geen nieuwe | | 409 | `not_ready`, `video_not_ready` | De video of een andere taak is nog niet voltooid | Vraag de status later op | | 409, 503 | `result_pending_check` | Het resultaat van het verzoek wordt nog gecontroleerd. Bij een videotaak is dit de vlag `result_pending_check: true` in het statusantwoord; de taak zelf blijft `in_progress` | Verstuur het verzoek niet opnieuw — de status verschijnt in de geschiedenis (GET https://ailoot.ai/api/v1/usage). Maak de videotaak niet opnieuw aan: controleer deze later via GET /v1/videos/{id} | | 410 | `model_retired` | Het model is buiten gebruik gesteld | Kies een nieuwe versie via GET /v1/models | | 413 | `request_too_large` | De verzoekbody is te groot | Verklein de bestanden of de geschiedenis | | 429 | `rate_limit_exceeded`, `gateway_concurrency_limit`, `gateway_queue_full` | Te veel verzoeken of gelijktijdige verzoeken vanaf je account | Wacht (header `Retry-After`, meestal 10 s) en probeer opnieuw | | 429 | `usage_limit_reached` | Het bestedingsvenster van de sleutel is opgebruikt (5 uur, 1 dag of 7 dagen) | Wacht totdat het venster vernieuwd is of verhoog de sleutellimiet | | 500 | `internal_error` | Ailoot-fout | Neem contact op met support met de Request ID | | 502 | `invalid_model_response`, `empty_response`, `incomplete_response` | Het model heeft een ongeldig, leeg of onvolledig antwoord teruggegeven | Zoek de Request ID op in de dashboardgeschiedenis. Als daar een resultaat of afschrijving staat, leidt opnieuw versturen tot een tweede betaald verzoek. Het ontbreken van een registratie is geen bewijs dat het verzoek niet is verzonden of niet is uitgevoerd: verstuur een verzoek met onbekende verzendstatus niet opnieuw; neem contact op met de ondersteuning en vermeld de Request ID. | | 502 | `result_not_delivered` | Het resultaat is door een fout van Ailoot niet geleverd; de reservering of afschrijving is teruggegeven | Je kunt het verzoek opnieuw versturen | | 503 | `model_overloaded` | Het model is tijdelijk overbelast | Als X-Should-Retry: true — probeer opnieuw na het aantal seconden in Retry-After; bij false — controleer eerst de Request ID in de geschiedenis | | 503 | `model_unavailable` | Het model is tijdelijk niet beschikbaar | Kies een ander model. Bij X-Should-Retry: true — probeer opnieuw na het aantal seconden in Retry-After; bij false — controleer eerst de Request ID in de geschiedenis | | 503 | `service_unavailable` | Tijdelijke storing bij Ailoot | Als X-Should-Retry: true — probeer opnieuw na het aantal seconden in Retry-After; bij false — controleer eerst de Request ID in de geschiedenis | | 503 | `charge_not_confirmed` | Het antwoord is niet geleverd: de afschrijving kon niet worden bevestigd; de reservering is vrijgegeven en er is niets afgeschreven | Als X-Should-Retry: true — probeer opnieuw na het aantal seconden in Retry-After; bij false — controleer eerst de Request ID in de geschiedenis | | 504 | `model_timeout` | Het model heeft niet op tijd geantwoord; het resultaat kan nog verschijnen | Verstuur het verzoek niet opnieuw voordat je de Request ID in de geschiedenis hebt gecontroleerd | De codes voor modelantwoorden en resultaatcontrole (502, 503 en 504) noemen nu het model of het verzoek: `model_unavailable`, `model_timeout`, `invalid_model_response`, `incomplete_response`, `charge_not_confirmed` en `result_pending_check`. Als je code `error.code` met de oude waarden vergelijkt, vervang die dan door de codes uit de tabel; voor de koppeling tussen oude en nieuwe codes kun je terecht bij [support](https://ailoot.ai/docs/nl-be/support/). ## [](https://ailoot.ai/docs/nl-be/errors/#retry)Wanneer je een verzoek opnieuw kunt proberen - **Bekijk eerst X-Should-Retry**: bij `false`, `result_pending_check` of `model_timeout` probeer je niet automatisch opnieuw. Zoek de Request ID op in de dashboardgeschiedenis: daar staan het resultaat en de afschrijving. - **Opnieuw proberen is veilig bij X-Should-Retry: true**: wacht `Retry-After` seconden. Bij 5xx is de code alleen niet genoeg: het resultaat kan al bestaan. Controleer eerst de dashboardgeschiedenis of neem contact op met support met de Request ID. Dit is vooral belangrijk voor afbeeldingen, video, muziek en langdurige stappen van een agent. - **Opnieuw proberen helpt niet**: 400, 401, 402, 403, 404 — pas eerst het verzoek, de sleutel of het saldo aan. OpenAI- en Anthropic-SDK’s proberen netwerkfouten en 5xx doorgaans automatisch opnieuw. Schakel dit uit voor generaties (`max_retries=0`) en controleer `X-Should-Retry` vóór een nieuwe poging. Een verloren antwoord betekent niet dat het verzoek niet is uitgevoerd. ## [](https://ailoot.ai/docs/nl-be/errors/#limits)Limieten De frequentie en het aantal gelijktijdige verzoeken zijn begrensd voor je hele account, niet per sleutel. Bij overschrijding krijg je 429 `rate_limit_exceeded` met de header `Retry-After: 10`. Is het model zelf overbelast, dan krijg je 503 `model_overloaded` met `Retry-After: 30`. Heb je meer capaciteit nodig, neem dan contact op met [support](https://ailoot.ai/docs/nl-be/support/). Bestedingslimieten stel je per sleutel in: de totale limiet geeft 402 `api_key_quota_exhausted`, de vensters van 5 uur, 1 dag en 7 dagen geven 429 `usage_limit_reached`. Meer informatie: [Sleutels en API-adres](https://ailoot.ai/docs/nl-be/keys/#key). ## [](https://ailoot.ai/docs/nl-be/errors/#nvidia)NVIDIA-modellen: wachtrij Je kunt de modellenlijst ook met een saldo van nul opvragen; voor generatie moet voldoende saldo voor de reservering beschikbaar zijn. NVIDIA-modellen (Nemotron en andere) gebruiken een gedeelde wachtrij: bij hoge belasting kan het antwoord later komen of krijg je de fout ‘model tijdelijk overbelast’ met een Retry-After-header — probeer opnieuw na de aangegeven wachttijd. De prijzen staan in de catalogus; afschrijvingen werken zoals bij andere modellen. Het model bepaalt de groottelimieten: context (hoeveel tokens je kunt versturen) en de maximale antwoordlengte. Ze staan in de [catalogus](https://ailoot.ai/models/nl-be/). ## Geschiedenis en kosten [Geschiedenis en kosten](https://ailoot.ai/usage) · [GET https://ailoot.ai/api/v1/usage](https://ailoot.ai/docs/nl-be/cabinet/usage/) · JWT · `Authorization: Bearer $TOKEN` `JWT ≠ sk-…` · [Aanmelden en sessies](https://ailoot.ai/docs/nl-be/cabinet/auth/) Nog vragen? Stuur de Request ID en een beschrijving — we helpen je verder.[Contact opnemen met support](mailto:support@ailoot.ai) ## Ailoot · Het bedrijf en zijn projectenportefeuille Ailoot bouwt op opgebouwde operationele ervaring, een groot klantenbestand, een stabiele dienst en doorlopende KPI-controle. Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden. Ailoot gebruikt die operationele ervaring voor API-toegang tot AI-functies in klantproducten, agents, applicaties en automatiseringen.