Xatolar va limitlar

Xato siz chaqirgan API formatida keladi: obyekt error OpenAI uchun, {"type": "error", "error": {...}} Anthropic uchun va error quyidagi maydonlar bilan status va details Gemini uchun. Shu sababli SDK’lar ularni odatiy API xatolari sifatida taniydi.

• error.code va error.reason — quyidagi jadvaldagi xato sinfi; ikkalasi bir xil. error.type — formatning standart qiymati (masalan, invalid_request_error yoki server_error).
• error.request_id (Anthropic’da — request_id yuqori darajada), sarlavha X-Request-ID va xabar matnining oxiri — so‘rov identifikatori.
• Gemini’da sinf quyidagi maydonda: error.details: ErrorInfo.reason — shu kodning bosh harflardagi shakli (masalan, MODEL_OVERLOADED), domain — ailoot.ai; so‘rov identifikatori esa quyidagi maydonda: RequestInfo.requestId.
• Gemini formatida avtomatik takrorlash mumkin bo‘lmagan 5xx xatosi va result_pending_check 409 holati va status ABORTED bilan keladi: shunda Gemini SDK va CLI ularni o‘zi takrorlamaydi. Xato sinfi quyidagi maydonda: ErrorInfo.reason (masalan, MODEL_TIMEOUT yoki RESULT_PENDING_CHECK).
• OpenAI formatidagi javobda yuqori darajadagi quyidagi maydonlar ham bor: code va message — eski mijoz dasturlari uchun.

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

Model javoblari va natijani tekshirish kodlari (502, 503 va 504) endi model yoki so‘rovni bildiradi: model_unavailable, model_timeout, invalid_model_response, incomplete_response, charge_not_confirmed va result_pending_check. Kodingiz error.code ni eski qiymatlar bilan solishtirsa, ularni jadvaldagi kodlarga almashtiring; eski va yangi kodlar mosligini aytib beradi — yordam xizmati.

• Avval X-Should-Retry’ni tekshiring: quyidagi holatlarda false, result_pending_check yoki model_timeout avtomatik takrorlamang. Boshqaruv paneli tarixidan Request ID’ni toping: u yerda natija va yechib olingan summa ko‘rinadi.
• X-Should-Retry: true kelganda takrorlash xavfsiz: kuting Retry-After soniya. 5xx uchun kodning o‘zi yetarli emas: natija allaqachon paydo bo‘lgan bo‘lishi mumkin. Avval boshqaruv panelidagi tarixni tekshiring yoki Request ID bilan yordam xizmatiga yozing. Bu ayniqsa rasmlar, video, musiqa va uzun agent qadamlari uchun muhim.
• Takrorlash yordam bermaydi: 400, 401, 402, 403, 404 — avval so‘rov, kalit yoki balansni tuzating.

Chastota va bir vaqtdagi so‘rovlar soni alohida kalit uchun emas, butun hisobingiz uchun cheklangan. Chegaradan oshganda 429 keladi rate_limit_exceeded Quyidagi sarlavha bilan: Retry-After: 10. Modelning o‘zi ortiqcha yuklangan bo‘lsa — 503 model_overloaded quyidagiga ega: Retry-After: 30. Kattaroq yuklama kerak bo‘lsa, yozing: yordam xizmatiga.

Sarf limitlari kalitda belgilanadi: umumiy limit — 402 api_key_quota_exhausted, 5 soat, 1 kun va 7 kunlik davrlar — 429 usage_limit_reached. Batafsil — Kalitlar va API manzili.

Modellar ro‘yxatini balans nol bo‘lganda ham so‘rash mumkin; generatsiya uchun zaxiraga yetadigan balans kerak. NVIDIA modellari (Nemotron va boshqalar) umumiy navbat orqali ishlaydi: yuklama katta bo‘lsa, javob kechroq kelishi yoki Retry-After sarlavhali «model vaqtincha ortiqcha yuklangan» xatosi qaytishi mumkin — ko‘rsatilgan vaqtdan keyin takrorlang. Narxlar katalogda, yechib olish boshqa modellardagidek.

Hajm limitlarini model belgilaydi: kontekst (qancha token yuborish mumkin) va javobning maksimal uzunligi. Ular quyidagi joyda ko‘rsatilgan: katalogda.