Fejl og grænser

Fejlen kommer i formatet for det API, du kaldte: objektet error for OpenAI, {"type": "error", "error": {...}} for Anthropic og error med felterne status og details for Gemini. Derfor genkender SDK'erne dem som almindelige API-fejl.

• error.code og error.reason — fejlklassen fra tabellen nedenfor; værdierne er de samme. error.type — formatets standardværdi (for eksempel invalid_request_error eller server_error).
• error.request_id (i Anthropic — request_id på øverste niveau), headeren X-Request-ID og slutningen af beskedteksten — anmodningens identifikator.
• I Gemini ligger klassen i error.details: ErrorInfo.reason — samme kode med store bogstaver (for eksempel MODEL_OVERLOADED), domain — ailoot.ai; anmodningens identifikator ligger i RequestInfo.requestId.
• I Gemini-format kommer en 5xx-fejl, som ikke må gentages automatisk, og result_pending_check med status 409 og status ABORTED: så gentager Gemini SDK og CLI dem ikke automatisk. Fejlklassen findes i ErrorInfo.reason (for eksempel MODEL_TIMEOUT eller RESULT_PENDING_CHECK).
• Svar i OpenAI-format indeholder også felterne på øverste niveau code og message — til ældre 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"
      }
    ]
  }
}

Koder for modelsvar og kontrol af resultatet (502, 503 og 504) henviser nu til modellen eller anmodningen: model_unavailable, model_timeout, invalid_model_response, incomplete_response, charge_not_confirmed og result_pending_check. Hvis din kode sammenligner error.code med de tidligere værdier, skal du erstatte dem med koderne fra tabellen; sammenhængen mellem gamle og nye koder kan oplyses af support.

• Se først på X-Should-Retry: ved false, result_pending_check eller model_timeout skal du ikke gentage automatisk. Find Request ID i kontrolpanelets historik: der vises resultat og debitering.
• En gentagelse er sikker, når X-Should-Retry: true modtages: vent Retry-After sekunder. Ved 5xx er koden alene ikke nok: resultatet kan allerede være kommet. Kontrollér først historikken i kontrolpanelet, eller kontakt support med Request ID. Det er særligt vigtigt for billeder, video, musik og lange agenttrin.
• En gentagelse hjælper ikke: 400, 401, 402, 403, 404 — ret først anmodningen, nøglen eller saldoen.

Frekvens og antal samtidige anmodninger begrænses for din konto samlet, ikke for den enkelte nøgle. Ved overskridelse får du 429 rate_limit_exceeded med headeren Retry-After: 10. Hvis selve modellen er overbelastet — 503 model_overloaded med Retry-After: 30. Hvis du har brug for højere belastning, skal du kontakte support.

Forbrugsgrænser sættes for nøglen: samlet grænse — 402 api_key_quota_exhausted, vinduer på 5 timer, 1 dag og 7 dage — 429 usage_limit_reached. Læs mere — Nøgler og API-adresse.

Modellisten kan også hentes med en saldo på nul; generering kræver saldo til reservationen. NVIDIA-modeller (Nemotron og andre) bruger en fælles kø: ved høj belastning kan svaret komme senere, eller du får fejlen »modellen er midlertidigt overbelastet« med Retry-After-headeren — prøv igen efter den angivne tid. Priserne findes i kataloget, og debiteringen sker som for de øvrige modeller.

Størrelsesgrænserne fastsættes af modellen: kontekst (hvor mange tokens du kan sende) og maksimal svarlængde. De er angivet i kataloget.