Feil og grenser

Feilen returneres i formatet til API-et du kalte: objektet error for OpenAI, {"type": "error", "error": {...}} for Anthropic og error med feltene status og details for Gemini. SDK-ene gjenkjenner dem derfor som vanlige API-feil.

• error.code og error.reason — feilklassen fra tabellen nedenfor; verdiene er de samme. error.type — formatets standardverdi (for eksempel invalid_request_error eller server_error).
• error.request_id (i Anthropic — request_id på toppnivå), headeren X-Request-ID og slutten av feilmeldingen angir forespørselsidentifikatoren.
• I Gemini ligger klassen i error.details: ErrorInfo.reason — samme kode med store bokstaver (for eksempel MODEL_OVERLOADED), domain — ailoot.ai; forespørselsidentifikatoren finnes i RequestInfo.requestId.
• I Gemini-format returneres en 5xx-feil som ikke skal gjentas automatisk, og result_pending_check med status 409 og status ABORTED: slik unngår Gemini SDK og CLI å gjenta dem automatisk. Feilklassen finnes i ErrorInfo.reason (for eksempel MODEL_TIMEOUT eller RESULT_PENDING_CHECK).
• Svaret i OpenAI-format inneholder også toppnivåfeltene code og message — for eldre klienter.

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

Kodene for modellsvar og resultatkontroll (502, 503 og 504) navngir nå modellen eller forespørselen: model_unavailable, model_timeout, invalid_model_response, incomplete_response, charge_not_confirmed og result_pending_check. Hvis koden din sammenligner error.code med tidligere verdier, erstatter du dem med kodene i tabellen; du kan få koblingen mellom gamle og nye koder fra brukerstøtte.

• Se først på X-Should-Retry: ved false, result_pending_check eller model_timeout skal du ikke gjenta automatisk. Finn Request ID i kontrollpanelets historikk: der ser du resultat og belastning.
• Det er trygt å gjenta når X-Should-Retry: true er returnert: vent Retry-After sekunder. For 5xx er statuskoden alene ikke nok: resultatet kan allerede finnes. Kontroller først historikken i kontrollpanelet, eller kontakt brukerstøtte med Request ID. Dette er særlig viktig for bilder, video, musikk og lange agenttrinn.
• Gjentakelse hjelper ikke: 400, 401, 402, 403, 404 — rett først forespørselen, nøkkelen eller saldoen.

Frekvens og antall samtidige forespørsler begrenses for kontoen som helhet, ikke per nøkkel. Ved overskridelse får du 429 rate_limit_exceeded med headeren Retry-After: 10. Hvis selve modellen er overbelastet, får du 503 model_overloaded med Retry-After: 30. Hvis du trenger høyere kapasitet, skriver du til brukerstøtte.

Forbruksgrenser settes på nøkkelen: samlet grense gir 402 api_key_quota_exhausted, vinduer på 5 timer, 1 dag og 7 dager gir 429 usage_limit_reached. Les mer — Nøkler og API-adresse.

Modellisten kan hentes med null saldo; generering krever saldo til reservasjonen. NVIDIA-modeller (Nemotron og andre) bruker en felles kø: ved stor belastning kan svaret komme senere, eller du får feilen «modellen er midlertidig overbelastet» med Retry-After-headeren — prøv igjen etter angitt tid. Prisene finnes i katalogen, og belastningen fungerer som for andre modeller.

Modellen bestemmer størrelsesgrensene: kontekst (hvor mange tokener du kan sende) og maksimal svarlengde. De er angitt i katalogen.