Fel och gränser

Felet returneras i formatet för det API du anropade: objektet error för OpenAI, {"type": "error", "error": {...}} för Anthropic och error med fälten status och details för Gemini. SDK:erna känner därför igen dem som vanliga API-fel.

• error.code och error.reason — felklassen i tabellen nedan; värdena är desamma. error.type — formatets standardvärde (till exempel invalid_request_error eller server_error).
• error.request_id (i Anthropic — request_id på toppnivå), headern X-Request-ID och slutet av felmeddelandet anger anropets identifierare.
• I Gemini finns klassen i error.details: ErrorInfo.reason — samma kod med versaler (till exempel MODEL_OVERLOADED), domain — ailoot.ai; anropets identifierare finns i RequestInfo.requestId.
• I Gemini-format returneras ett 5xx-fel som inte får upprepas automatiskt, och result_pending_check med status 409 och status ABORTED: på så sätt upprepar Gemini SDK och CLI dem inte automatiskt. Felklassen finns i ErrorInfo.reason (till exempel MODEL_TIMEOUT eller RESULT_PENDING_CHECK).
• Svaret i OpenAI-format innehåller även toppnivåfälten code och message — för ä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"
      }
    ]
  }
}

Koderna för modellsvar och resultatkontroll (502, 503 och 504) anger nu modellen eller anropet: model_unavailable, model_timeout, invalid_model_response, incomplete_response, charge_not_confirmed och result_pending_check. Om din kod jämför error.code med tidigare värden ersätter du dem med koderna i tabellen; kopplingen mellan gamla och nya koder får du av supporten.

• Kontrollera först X-Should-Retry: vid false, result_pending_check eller model_timeout ska du inte upprepa automatiskt. Hitta Request ID i kontrollpanelens historik: där visas resultat och debitering.
• Upprepning är säker när X-Should-Retry: true har returnerats: vänta Retry-After sekunder. För 5xx räcker inte enbart koden: resultatet kan redan finnas. Kontrollera först historiken i kontrollpanelen eller kontakta supporten med Request ID. Detta är särskilt viktigt för bilder, video, musik och långa agentsteg.
• Upprepning hjälper inte: 400, 401, 402, 403, 404 — rätta först anropet, nyckeln eller saldot.

Frekvens och antal samtidiga anrop begränsas för hela kontot, inte per nyckel. Vid överskridande returneras 429 rate_limit_exceeded med headern Retry-After: 10. Om själva modellen är överbelastad returneras 503 model_overloaded med Retry-After: 30. Behöver du högre kapacitet, kontakta supporten.

Utgiftsgränser anges för nyckeln: den totala gränsen ger 402 api_key_quota_exhausted, fönster på 5 timmar, 1 dag och 7 dagar ger 429 usage_limit_reached. Läs mer — Nycklar och API-adress.

Modellistan kan hämtas även vid nollsaldo; generering kräver saldo till reserveringen. NVIDIA-modeller (Nemotron och andra) använder en gemensam kö: vid hög belastning kan svaret komma senare eller felet ”modellen är tillfälligt överbelastad” returneras med Retry-After-headern — försök igen efter angiven tid. Priserna finns i katalogen, och debiteringen fungerar som för övriga modeller.

Modellen bestämmer storleksgränserna: kontext (hur många token som kan skickas) och maximal svarslängd. De anges i katalogen.