API ত্রুটি

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

HTTP ত্রুটি কোড

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

HTTP কোড অবস্থা বর্ণনা উদাহরণ সমাধান
৪০০ অবৈধ আর্গুমেন্ট অনুরোধের মূল অংশটি ত্রুটিপূর্ণ। আপনার অনুরোধে একটি মুদ্রণপ্রমাদ অথবা কোনো প্রয়োজনীয় ক্ষেত্র অনুপস্থিত রয়েছে। অনুরোধের বিন্যাস, উদাহরণ এবং সমর্থিত সংস্করণগুলির জন্য এপিআই রেফারেন্স দেখুন। পুরোনো এন্ডপয়েন্টে নতুন এপিআই সংস্করণের বৈশিষ্ট্য ব্যবহার করলে ত্রুটি হতে পারে।
৪০০ ব্যর্থ_পূর্বশর্ত আপনার দেশে জেমিনি এপিআই-এর ফ্রি টিয়ার উপলব্ধ নেই। অনুগ্রহ করে গুগল এআই স্টুডিও-তে আপনার প্রোজেক্টে বিলিং চালু করুন। আপনি এমন একটি অঞ্চল থেকে অনুরোধ করছেন যেখানে ফ্রি টিয়ার সমর্থিত নয়, এবং আপনি Google AI Studio-তে আপনার প্রোজেক্টের জন্য বিলিং চালু করেননি। জেমিনি এপিআই ব্যবহার করার জন্য, আপনাকে গুগল এআই স্টুডিও ব্যবহার করে একটি পেইড প্ল্যান সেটআপ করতে হবে।
৪০৩ অনুমতি_প্রত্যাখ্যাত আপনার এপিআই কী-তে প্রয়োজনীয় অনুমতি নেই। আপনি ভুল এপিআই কী ব্যবহার করছেন; আপনি যথাযথ প্রমাণীকরণ প্রক্রিয়া সম্পন্ন না করেই একটি টিউনড মডেল ব্যবহার করার চেষ্টা করছেন। আপনার এপিআই কী সেট করা আছে এবং সেটির সঠিক অ্যাক্সেস আছে কিনা তা যাচাই করুন। এবং টিউন করা মডেলগুলো ব্যবহার করার জন্য যথাযথ প্রমাণীকরণ প্রক্রিয়া সম্পন্ন করুন।
৪০৪ পাওয়া যায়নি অনুরোধকৃত রিসোর্সটি খুঁজে পাওয়া যায়নি। আপনার অনুরোধে উল্লেখিত কোনো ছবি, অডিও বা ভিডিও ফাইল খুঁজে পাওয়া যায়নি। আপনার অনুরোধের সমস্ত প্যারামিটার আপনার এপিআই সংস্করণের জন্য বৈধ কিনা তা যাচাই করুন।
৪২৯ সম্পদ নিঃশেষিত আপনি এপিআই-এর কোনো একটি রেট লিমিট (আরপিএম, টিপিএম, আরপিডি, স্পেন্ড, ইত্যাদি) অতিক্রম করেছেন। আপনি প্রয়োজনের চেয়ে বেশি অনুরোধ পাঠাচ্ছেন, প্রয়োজনের চেয়ে বেশি টোকেন ব্যবহার করছেন, অথবা আপনার অ্যাকাউন্টের বিলিং হিস্ট্রি এবং টিয়ার অনুযায়ী ব্যয়-ভিত্তিক সীমা অতিক্রম করছেন। আপনি মডেলের রেট লিমিটের মধ্যে আছেন কিনা তা যাচাই করুন। কিছুক্ষণ অপেক্ষা করে আবার চেষ্টা করুন। আপনার অনুরোধের হার বা আকার হ্রাস করুন। প্রয়োজনে রেট লিমিট বৃদ্ধির জন্য অনুরোধ করুন
৪৯৯ বাতিল করা হয়েছে অপারেশনটি বাতিল করা হয়েছিল, সাধারণত ফোনকারীর দ্বারাই। এপিআই-এর প্রতিক্রিয়া সম্পূর্ণ হওয়ার আগেই ক্লায়েন্ট সংযোগটি বন্ধ করে দিয়েছে। আপনার ক্লায়েন্ট বা নেটওয়ার্ক পরিকাঠামো সময়ের আগেই সংযোগ বন্ধ করে দিচ্ছে কিনা তা পরীক্ষা করুন (যেমন, ক্লায়েন্ট-সাইড টাইমআউটের কারণে)।
৫০০ অভ্যন্তরীণ গুগলের পক্ষ থেকে একটি অপ্রত্যাশিত ত্রুটি ঘটেছে। আপনার ইনপুট কনটেক্সট অনেক দীর্ঘ। কোনো চলমান ঘটনার জন্য জেমিনি এপিআই স্ট্যাটাস পেজটি দেখুন। আপনার ইনপুট কনটেক্সট কমিয়ে দিন অথবা সাময়িকভাবে অন্য কোনো মডেলে (যেমন জেমিনি ২.৫ প্রো থেকে জেমিনি ২.৫ ফ্ল্যাশ-এ) পরিবর্তন করে দেখুন এটি কাজ করে কিনা। অথবা কিছুক্ষণ অপেক্ষা করে আপনার অনুরোধটি পুনরায় চেষ্টা করুন। পুনরায় চেষ্টা করার পরেও যদি সমস্যাটি থেকে যায়, তাহলে অনুগ্রহ করে গুগল এআই স্টুডিও-তে থাকা 'সেন্ড ফিডব্যাক' বাটনটি ব্যবহার করে বিষয়টি রিপোর্ট করুন।
৫০৩ অনুপলব্ধ পরিষেবাটি সাময়িকভাবে অতিরিক্ত চাপের কারণে বন্ধ থাকতে পারে। পরিষেবাটির ধারণক্ষমতা সাময়িকভাবে ফুরিয়ে আসছে। কোনো চলমান ঘটনার জন্য জেমিনি এপিআই স্ট্যাটাস পেজটি দেখুন। সাময়িকভাবে অন্য একটি মডেলে (যেমন জেমিনি ২.৫ প্রো থেকে জেমিনি ২.৫ ফ্ল্যাশ-এ) পরিবর্তন করে দেখুন এটি কাজ করে কিনা। অথবা কিছুক্ষণ অপেক্ষা করে আপনার অনুরোধটি পুনরায় চেষ্টা করুন। পুনরায় চেষ্টা করার পরেও যদি সমস্যাটি থেকে যায়, তাহলে অনুগ্রহ করে গুগল এআই স্টুডিও-তে থাকা 'সেন্ড ফিডব্যাক' বাটনটি ব্যবহার করে বিষয়টি জানান।
৫০৪ সময়সীমা অতিক্রম করেছে পরিষেবাটি নির্ধারিত সময়সীমার মধ্যে প্রক্রিয়াকরণ শেষ করতে পারছে না। আপনার দেওয়া নির্দেশ (বা প্রেক্ষাপট) এতটাই বড় যে তা সময়মতো প্রক্রিয়াজাত করা সম্ভব নয়। এই ত্রুটি এড়াতে আপনার ক্লায়েন্ট অনুরোধে একটি বৃহত্তর 'টাইমআউট' সেট করুন।

ত্রুটি প্রতিক্রিয়া বিন্যাস

যখন একটি 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

এরপর কী?