API সংক্রান্ত সমস্যা

এই পৃষ্ঠায় GenerateContent API-এর মাধ্যমে ফেরত পাঠানো ব্যাকএন্ড সমস্যার কোডের রেফারেন্স দেওয়া হয়েছে, gRPC সমস্যার রেসপন্স ফর্ম্যাট বর্ণনা করা হয়েছে এবং সমস্যার সমাধান করার ধাপ দেওয়া হয়েছে।

HTTP সংক্রান্ত সমস্যার কোড

নিচের সারণীতে সাধারণ ব্যাকএন্ড ত্রুটি কোড, তাদের কারণের ব্যাখ্যা এবং প্রস্তাবিত সমাধানগুলি তালিকাভুক্ত করা হয়েছে:

HTTP কোড স্ট্যাটাস বিবরণ উদাহরণ সমাধান
400 INVALID_ARGUMENT অনুরোধের প্রধান অংশটি ভুল ফর্ম্যাটে আছে। আপনার অনুরোধে কোনও টাইপো আছে অথবা প্রয়োজনীয় ফিল্ড ফাঁকা আছে। অনুরোধের ফর্ম্যাট, উদাহরণ ও কাজ করে এমন ভার্সন সম্পর্কে জানতে API রেফারেন্স চেক করুন। পুরনো এন্ডপয়েন্টের সাথে নতুন API ভার্সনের ফিচার ব্যবহার করলে সমস্যা হতে পারে।
400 FAILED_PRECONDITION Gemini API-এর ফ্রি টিয়ার আপনার দেশে উপলভ্য নয়। Google AI Studio-তে আপনার প্রোজেক্টের জন্য বিলিং চালু করুন। আপনি এমন একটি অঞ্চল থেকে অনুরোধ করছেন যেখানে ফ্রি টিয়ার কাজ করে না এবং আপনি Google AI Studio-তে আপনার প্রোজেক্টের জন্য বিলিং চালু করেননি। Gemini API ব্যবহার করতে, আপনাকে Google AI Studio ব্যবহার করে একটি পেড প্ল্যান সেট-আপ করতে হবে।
402 RESOURCE_EXHAUSTED আপনার প্রিপে ক্রেডিট ব্যালেন্স শেষ হয়ে গেছে। আপনার বিলিং অ্যাকাউন্টে প্রিপে ক্রেডিট শেষ হয়ে গেছে, তাই সেই বিলিং অ্যাকাউন্টের সাথে লিঙ্ক করা প্রতিটি API কী কাজ করা বন্ধ করে দেয়। আপনার বিলিং অ্যাকাউন্টে ক্রেডিট যোগ করুন অথবা অটোমেটিক রিলোড ফিচার চালু করুন। এই অনুরোধের জন্য আবার চেষ্টা করবেন না: ক্রেডিট যোগ না করা পর্যন্ত এটি সফল হবে না।
403 PERMISSION_DENIED আপনার API কী-তে প্রয়োজনীয় অনুমতি নেই অথবা আপনার প্রোজেক্টের API অ্যাক্সেস সীমিত করা হয়েছে। আপনি ভুল বা ফাঁস হয়ে যাওয়া API key ব্যবহার করছেন, আপনার প্রোজেক্ট ফ্রি টিয়ারের জন্য উপযুক্ত নয়, আপনার বিলিং অ্যাকাউন্টে বকেয়া ব্যালেন্স আছে অথবা আপনি যথাযথ যাচাইকরণ না করেই টিউন করা মডেল ব্যবহার করার চেষ্টা করছেন। আপনার API কী সঠিক ও অ্যাক্টিভ আছে কিনা তা চেক করুন, Google AI Studio-তে আপনার প্রোজেক্টের বিলিং ও টিয়ার স্ট্যাটাস যাচাই করুন অথবা প্রোজেক্ট সীমাবদ্ধ বা উপলভ্য না থাকা সংক্রান্ত সমস্যার সমাধান করুন দেখুন।
404 NOT_FOUND অনুরোধ করা রিসোর্স খুঁজে পাওয়া যায়নি। আপনার অনুরোধে উল্লেখ করা ছবি, অডিও বা ভিডিও ফাইল খুঁজে পাওয়া যায়নি। আপনার অনুরোধের সব প্যারামিটার আপনার API ভার্সনের জন্য সঠিক কিনা তা চেক করুন।
429 RESOURCE_EXHAUSTED আপনি API-এর রেট লিমিটের (RPM, TPM, RPD, খরচ ইত্যাদি) মধ্যে কোনও একটি পেরিয়ে গেছেন। আপনি অনেক বেশি অনুরোধ পাঠাচ্ছেন, অনেক বেশি টোকেন ব্যবহার করছেন অথবা আপনার অ্যাকাউন্টের বিলিং ইতিহাস ও টিয়ারের জন্য খরচ-ভিত্তিক সীমা অতিক্রম করছেন। আপনি মডেলের রেট সীমার মধ্যে আছেন কিনা তা যাচাই করুন। কিছুক্ষণ অপেক্ষা করে আবার চেষ্টা করুন। আপনার অনুরোধের রেট বা সাইজ কমান। প্রয়োজন হলে রেটের সীমা বাড়ানোর অনুরোধ করুন।
499 বাতিল করা হয়েছে অপারেশন বাতিল করা হয়েছে, সাধারণত কলার এটি করেন। API উত্তর দেওয়া শেষ করার আগেই ক্লায়েন্ট কানেকশন বন্ধ করে দিয়েছে। আপনার ক্লায়েন্ট বা নেটওয়ার্ক ইনফ্রাস্ট্রাকচার সময়ের আগেই কানেকশন বন্ধ করে দিচ্ছে কিনা তা চেক করুন (যেমন, ক্লায়েন্ট-সাইড টাইমআউটের কারণে)।
500 ইন্টার্নাল Google-এর দিক থেকে কোনও অপ্রত্যাশিত সমস্যা হয়েছে। আপনার ইনপুট কনটেক্সট অনেক দীর্ঘ। কোনও ঘটনা চলছে কিনা তা জানতে Gemini API স্ট্যাটাস পৃষ্ঠা চেক করুন। আপনার ইনপুট কন্টেক্সট কমান অথবা সাময়িকভাবে অন্য মডেলে (যেমন, Gemini 2.5 Pro থেকে Gemini 2.5 Flash-এ) পাল্টে নিয়ে দেখুন কাজ হচ্ছে কিনা। অথবা একটু অপেক্ষা করে আবার অনুরোধ করুন। আবার চেষ্টা করার পরেও সমস্যাটি থেকে গেলে, Google AI Studio-তে মতামত পাঠান বোতাম ব্যবহার করে এটি সম্পর্কে অভিযোগ জানান।
503 উপলভ্য নেই পরিষেবা সাময়িকভাবে ওভারলোড বা ডাউন হয়ে থাকতে পারে। পরিষেবাটি সাময়িকভাবে তার ক্যাপাসিটির সর্বাধিক সীমায় পৌঁছে গেছে। কোনও ঘটনা চলছে কিনা তা জানতে Gemini API স্ট্যাটাস পৃষ্ঠা চেক করুন। সাময়িকভাবে অন্য মডেলে পাল্টে নিন (যেমন, Gemini 2.5 Pro থেকে Gemini 2.5 Flash) এবং এটি কাজ করছে কিনা দেখুন। অথবা একটু অপেক্ষা করে আবার অনুরোধ করুন। আবার চেষ্টা করার পরেও সমস্যাটি থেকে গেলে, Google AI Studio-তে মতামত পাঠান বোতাম ব্যবহার করে এটি সম্পর্কে অভিযোগ জানান।
504 DEADLINE_EXCEEDED পরিষেবাটি নির্দিষ্ট সময়সীমার মধ্যে প্রসেসিং শেষ করতে পারেনি। আপনার প্রম্পট (বা প্রসঙ্গ) অনেক বড়, তাই সময়মতো প্রসেস করা যাবে না। এই সমস্যা এড়াতে আপনার ক্লায়েন্ট অনুরোধে আরও বেশি 'টাইম-আউট' সেট করুন।

সমস্যার উত্তর দেওয়ার ফর্ম্যাট

GenerateContent অনুরোধ ব্যর্থ হলে, API, HTTP স্ট্যাটাস কোড (যেমন 400 Bad Request, 403 Forbidden বা 429 Too Many Requests) সেট করে এবং gRPC স্ট্যাটাসের বিবরণ সহ JSON রেসপন্স বডি ফেরত পাঠায়:

{
  "error": {
    "code": 400,
    "message": "API key not valid. Please pass a valid API key.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "API_KEY_INVALID",
        "domain": "googleapis.com",
        "metadata": {
          "service": "generativelanguage.googleapis.com"
        }
      },
      {
        "@type": "type.googleapis.com/google.rpc.LocalizedMessage",
        "locale": "en-US",
        "message": "API key not valid. Please pass a valid API key."
      }
    ]
  }
}
ফিল্ড ধরন বিবরণ
code পূর্ণসংখ্যা HTTP স্ট্যাটাস কোড।
message স্ট্রিং সমস্যার মানুষের-পঠনযোগ্য বিবরণ।
status স্ট্রিং SCREAMING_CASE-এ gRPC স্ট্যাটাস কোড।
details এরে সমস্যার অতিরিক্ত প্রসঙ্গ, যেমন ErrorInfo বা LocalizedMessage।

এর পরে কী করতে হবে