Fouten en limieten

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.

{
  "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 <key>\". 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. …"
}

{
  "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"
}

{
  "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"
      }
    ]
  }
}

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.

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

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.

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.

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.