Chyby a limity

Chyba se vrací ve formátu API, které jste zavolali: objekt error pro OpenAI, {"type": "error", "error": {...}} pro Anthropic a error s poli status a details pro Gemini. SDK je proto rozpoznají jako běžné chyby API.

• error.code a error.reason – třída chyby z níže uvedené tabulky; obě hodnoty se shodují. error.type – standardní hodnota daného formátu (například invalid_request_error nebo server_error).
• error.request_id (v Anthropic – request_id na nejvyšší úrovni), hlavička X-Request-ID a konec textu zprávy – identifikátor požadavku.
• V Gemini je třída v error.details: ErrorInfo.reason – stejný kód velkými písmeny (například MODEL_OVERLOADED), domain – ailoot.ai; identifikátor požadavku je v RequestInfo.requestId.
• Ve formátu Gemini chyba 5xx, kterou nelze automaticky opakovat, a result_pending_check se vracejí se statusem 409 a status ABORTED: Gemini SDK a CLI je tak samy neopakují. Třída chyby je v ErrorInfo.reason (například MODEL_TIMEOUT nebo RESULT_PENDING_CHECK).
• Odpověď ve formátu OpenAI obsahuje také pole na nejvyšší úrovni code a message – pro starší klienty.

{
  "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 pro odpovědi modelu a ověřování výsledku (502, 503 a 504) nyní označují model nebo požadavek: model_unavailable, model_timeout, invalid_model_response, incomplete_response, charge_not_confirmed a result_pending_check. Pokud váš kód porovnává error.code s dřívějšími hodnotami, nahraďte je kódy z tabulky; mapování starých kódů na nové vám poskytne podpora.

• Nejprve zkontrolujte X-Should-Retry: při false, result_pending_check nebo model_timeout požadavek automaticky neopakujte. Najděte Request ID v historii uživatelského panelu: jsou tam vidět výsledek i odečtená částka.
• Opakování je bezpečné, pokud přišlo X-Should-Retry: true: počkejte Retry-After sekund. U 5xx samotný kód nestačí: výsledek se již mohl objevit. Nejprve zkontrolujte historii v uživatelském panelu nebo kontaktujte podporu s Request ID. To je obzvlášť důležité u obrázků, videa, hudby a dlouhých kroků agentů.
• Opakování nepomůže: 400, 401, 402, 403, 404 – nejprve opravte požadavek, klíč nebo zůstatek.

Frekvence a počet souběžných požadavků jsou omezeny pro celý váš účet, nikoli pro jednotlivý klíč. Při překročení přijde 429 rate_limit_exceeded s hlavičkou Retry-After: 10. Pokud je přetížený samotný model – 503 model_overloaded s Retry-After: 30. Pokud potřebujete větší zátěž, kontaktujte podporu.

Limity útraty se nastavují u klíče: celkový limit – 402 api_key_quota_exhausted, časová okna 5 hodin, 1 den a 7 dní – 429 usage_limit_reached. Podrobnosti – Klíče a adresa API.

Seznam modelů lze získat i při nulovém zůstatku; pro generování je potřeba dostatek prostředků na rezervaci. Modely NVIDIA (Nemotron a další) používají společnou frontu: při vysoké zátěži může odpověď přijít později nebo se vrátí chyba „model je dočasně přetížený“ s hlavičkou Retry-After – zkuste to znovu po uvedené době. Ceny najdete v katalogu, částka se odečítá stejně jako u ostatních modelů.

Limity velikosti určuje model: kontext (kolik tokenů lze odeslat) a maximální délku odpovědi. Jsou uvedeny v katalogu.