Қателер және лимиттер

Қате шақырған API форматына сай келеді: мына нысан: error OpenAI үшін, {"type": "error", "error": {...}} Anthropic үшін және error мына өрістері бар: status және details Gemini үшін. Сондықтан SDK оларды кәдімгі API қателері ретінде таниды.

• error.code және error.reason — төмендегі кестедегі қате класы, олардың мәндері бірдей. error.type — форматтың стандартты мәні (мысалы, invalid_request_error немесе server_error).
• error.request_id (Anthropic ішінде — request_id жоғарғы деңгейде), мына тақырып: X-Request-ID және хабарлама мәтінінің соңы — сұрау идентификаторы.
• Gemini ішінде класс мына жерде: error.details: ErrorInfo.reason — сол код бас әріптермен (мысалы, MODEL_OVERLOADED), domain — ailoot.ai; сұрау идентификаторы — мына жерде: RequestInfo.requestId.
• Gemini форматында автоматты түрде қайталауға болмайтын 5xx қатесі және result_pending_check 409 күйімен және мына мәнмен келеді: status ABORTED: сонда Gemini SDK мен CLI оларды өздері қайталамайды. Қате класы — мына жерде: ErrorInfo.reason (мысалы, MODEL_TIMEOUT немесе RESULT_PENDING_CHECK).
• OpenAI форматындағы жауапта қосымша жоғарғы деңгей өрістері бар: code және message — ескі клиенттер үшін.

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

Модель жауаптары мен нәтижені тексеру кодтары (502, 503 және 504) енді модельді немесе сұрауды атайды: model_unavailable, model_timeout, invalid_model_response, incomplete_response, charge_not_confirmed және result_pending_check. Кодыңыз мына өрісті: error.code бұрынғы мәндермен салыстырса, оларды кестедегі кодтарға ауыстырыңыз; бұрынғы және жаңа кодтардың сәйкестігін мына қызмет түсіндіреді: қолдау қызметі.

• Алдымен X-Should-Retry мәнін қараңыз: мәні false, result_pending_check немесе model_timeout болса, автоматты түрде қайталамаңыз. Жеке кабинет тарихынан Request ID-ді табыңыз: онда нәтиже мен есептен шығару көрінеді.
• X-Should-Retry: true келгенде қайталау қауіпсіз: күтіңіз, Retry-After секунд. 5xx үшін кодтың өзі жеткіліксіз: нәтиже пайда болып қойған болуы мүмкін. Алдымен жеке кабинеттегі тарихты тексеріңіз немесе Request ID-мен қолдау қызметіне жазыңыз. Бұл әсіресе суреттер, бейне, музыка және агенттің ұзақ қадамдары үшін маңызды.
• Қайталау көмектеспейді: 400, 401, 402, 403, 404 — алдымен сұрауды, кілтті немесе балансты түзетіңіз.

Жиілік пен бір мезгілдегі сұраулар саны жеке кілт үшін емес, бүкіл аккаунтыңыз үшін шектеледі. Шектен асса, 429 келеді: rate_limit_exceeded мына тақырыппен: Retry-After: 10. Модельдің өзі шамадан тыс жүктелсе — 503: model_overloaded мынамен бірге: Retry-After: 30. Үлкен жүктеме қажет болса, мына қызметке жазыңыз: қолдау қызметіне.

Шығын лимиттері кілтте қойылады: жалпы лимит — 402 api_key_quota_exhausted, 5 сағат, 1 күн және 7 күн аралықтары — 429 usage_limit_reached. Толығырақ — Кілттер және API мекенжайы.

Модельдер тізімін нөлдік баланста да сұрауға болады; генерация үшін резервке баланс қажет. NVIDIA модельдері (Nemotron және басқалары) ортақ кезек арқылы жұмыс істейді: жүктеме жоғары болса, жауап кешірек келуі мүмкін немесе Retry-After тақырыбы бар «модель уақытша шамадан тыс жүктелген» қатесі қайтарылады — көрсетілген уақыттан кейін қайталаңыз. Бағалар каталогта, есептен шығару басқа модельдердегідей.

Көлем лимиттерін модель белгілейді: контекст (қанша токен жіберуге болады) және жауаптың ең көп ұзындығы. Олар мына жерде көрсетілген: каталогта.