Napake in omejitve

Napaka prispe v formatu API-ja, ki ste ga poklicali: objekt error pri OpenAI, {"type": "error", "error": {...}} pri Anthropic in error s poljema status in details pri Gemini. Zato jih SDK prepoznajo kot običajne napake API-ja.

• error.code in error.reason – razred napake iz spodnje tabele; vrednosti se ujemata. error.type – standardna vrednost formata (na primer, invalid_request_error ali server_error).
• error.request_id (pri Anthropic – request_id na najvišji ravni), glava X-Request-ID in konec besedila sporočila – identifikator zahteve.
• Pri Gemini je razred v error.details: ErrorInfo.reason – ista koda z velikimi črkami (na primer, MODEL_OVERLOADED), domain – ailoot.ai; identifikator zahteve je v RequestInfo.requestId.
• Pri formatu Gemini napaka 5xx, ki je ni dovoljeno samodejno ponoviti, in result_pending_check prispeta s statusom 409 in status ABORTED: tako ju Gemini SDK in CLI ne ponovita sama. Razred napake je v ErrorInfo.reason (na primer, MODEL_TIMEOUT ali RESULT_PENDING_CHECK).
• Odgovor v formatu OpenAI vsebuje še polji na najvišji ravni code in message – za starejše odjemalce.

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

Kode za odgovore modela in preverjanje rezultata (502, 503 in 504) zdaj poimenujejo model ali zahtevo: model_unavailable, model_timeout, invalid_model_response, incomplete_response, charge_not_confirmed in result_pending_check. Če vaša koda primerja error.code s prejšnjimi vrednostmi, jih zamenjajte s kodami iz tabele; pri povezovanju starih kod z novimi vam pomaga podpora.

• Najprej preverite X-Should-Retry: pri false, result_pending_check ali model_timeout ne ponavljajte samodejno. Poiščite Request ID v zgodovini nadzorne plošče: tam sta prikazana rezultat in bremenitev.
• Ponovitev je varna, ko prejmete X-Should-Retry: true: počakajte Retry-After sekund. Pri 5xx sama koda ni dovolj: rezultat se je morda že pojavil. Najprej preverite zgodovino na nadzorni plošči ali pišite podpori z Request ID. To je posebej pomembno pri slikah, videu, glasbi in dolgih korakih agentov.
• Ponovitev ne pomaga: 400, 401, 402, 403, 404 – najprej popravite zahtevo, ključ ali stanje.

Pogostost in število sočasnih zahtev sta omejena za celotni račun, ne za posamezni ključ. Ob prekoračitvi prejmete 429 rate_limit_exceeded z glavo Retry-After: 10. Če je preobremenjen sam model – 503 model_overloaded z Retry-After: 30. Če potrebujete večjo obremenitev, pišite podpori.

Omejitve porabe se določijo pri ključu: skupna omejitev – 402 api_key_quota_exhausted, okna 5 ur, 1 dan in 7 dni – 429 usage_limit_reached. Več informacij – Ključi in naslov API-ja.

Seznam modelov lahko zahtevate tudi pri ničelnem stanju; za generiranje potrebujete sredstva za rezervacijo. Modeli NVIDIA (Nemotron in drugi) delujejo prek skupne čakalne vrste: pri visoki obremenitvi odgovor lahko prispe pozneje ali prejmete napako »model je začasno preobremenjen« z glavo Retry-After – ponovite po navedenem času. Cene so v katalogu, bremenitev pa poteka enako kot pri drugih modelih.

Omejitve velikosti določa model: kontekst (koliko žetonov lahko pošljete) in največja dolžina odgovora. Navedene so v katalogu.