Chyby a limity

Chyba príde vo formáte API, ktoré ste zavolali: objekt error pre OpenAI, {"type": "error", "error": {...}} pre Anthropic a error s poľami status a details pre Gemini. SDK ich preto rozpoznajú ako bežné chyby API.

• error.code a error.reason – trieda chyby z tabuľky nižšie; tieto hodnoty sú rovnaké. error.type – štandardná hodnota daného formátu (napríklad invalid_request_error alebo server_error).
• error.request_id (v Anthropic request_id na najvyššej úrovni), hlavička X-Request-ID a koniec textu správy obsahujú identifikátor požiadavky.
• V Gemini je trieda v error.details: ErrorInfo.reason – rovnaký kód veľkými písmenami (napríklad MODEL_OVERLOADED), domain – ailoot.ai; identifikátor požiadavky je v RequestInfo.requestId.
• Vo formáte Gemini chyba 5xx, ktorú nemožno automaticky opakovať, a result_pending_check prichádzajú so stavom 409 a status ABORTED: SDK a CLI Gemini ich tak samy neopakujú. Trieda chyby je v ErrorInfo.reason (napríklad MODEL_TIMEOUT alebo RESULT_PENDING_CHECK).
• Odpoveď vo formáte OpenAI obsahuje aj polia najvyššej úrovne code a message – pre starších klientov.

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

Kódy pre odpovede modelu a overovanie výsledku (502, 503 a 504) teraz pomenúvajú model alebo požiadavku: model_unavailable, model_timeout, invalid_model_response, incomplete_response, charge_not_confirmed a result_pending_check. Ak váš kód porovnáva error.code s pôvodnými hodnotami, nahraďte ich kódmi z tabuľky; priradenie pôvodných kódov k novým vám poskytne podpora.

• Najprv skontrolujte X-Should-Retry: pri false, result_pending_check alebo model_timeout neopakujte automaticky. Vyhľadajte Request ID v histórii účtu: uvidíte tam výsledok aj zaúčtovanie.
• Opakovanie je bezpečné, keď príde X-Should-Retry: true: počkajte Retry-After sekúnd. Pri 5xx samotný kód nestačí: výsledok sa už mohol objaviť. Najprv overte históriu v účte alebo napíšte podpore s Request ID. Je to obzvlášť dôležité pri obrázkoch, videu, hudbe a dlhých krokoch agentov.
• Opakovanie nepomôže: 400, 401, 402, 403, 404 – najprv opravte požiadavku, kľúč alebo zostatok.

Frekvencia a počet súbežných požiadaviek sú obmedzené pre celý váš účet, nie pre jednotlivý kľúč. Pri prekročení príde 429 rate_limit_exceeded s hlavičkou Retry-After: 10. Ak je preťažený samotný model, 503 model_overloaded s Retry-After: 30. Ak potrebujete vyššiu záťaž, napíšte podpore.

Limity výdavkov sa nastavujú pri kľúči: celkový limit – 402 api_key_quota_exhausted, okná 5 hodín, 1 deň a 7 dní – 429 usage_limit_reached. Viac informácií – Kľúče a adresa API.

Zoznam modelov možno načítať aj pri nulovom zostatku; generovanie vyžaduje prostriedky na rezerváciu. Modely NVIDIA (Nemotron a ďalšie) pracujú cez spoločný front: pri vysokej záťaži môže odpoveď prísť neskôr alebo sa vráti chyba „model je dočasne preťažený“ s hlavičkou Retry-After – skúste znova po uvedenom čase. Ceny sú v katalógu, účtovanie funguje ako pri ostatných modeloch.

Limity veľkosti určuje model: kontext (koľko tokenov možno odoslať) a maximálnu dĺžku odpovede. Sú uvedené v katalógu.