এই পৃষ্ঠায় জেমিনি এপিআই এবং ফায়ারবেস এআই লজিক এসডিকে-এর সাধারণ ত্রুটি কোডগুলোর সমাধান দেওয়া হয়েছে।
যদি আপনি API key not valid. Please pass a valid API key. লেখা একটি 400 এরর পান, তাহলে এর মানে সাধারণত এই যে, আপনার Firebase কনফিগারেশন ফাইল/অবজেক্টে থাকা API কী-টি হয় বিদ্যমান নেই অথবা আপনার অ্যাপ এবং/অথবা Firebase প্রজেক্টের সাথে ব্যবহারের জন্য সেটআপ করা নেই।
আপনার Firebase কনফিগারেশন ফাইল/অবজেক্টে তালিকাভুক্ত API কী-টি আপনার অ্যাপের API কী-এর সাথে মেলে কিনা তা যাচাই করুন। আপনি Google Cloud কনসোলের APIs & Services > Credentials প্যানেলে আপনার সমস্ত API কী দেখতে পারেন।
যদি দেখেন যে এগুলি মিলছে না, তাহলে একটি নতুন Firebase কনফিগারেশন ফাইল/অবজেক্ট সংগ্রহ করুন এবং আপনার অ্যাপে থাকা ফাইলটি প্রতিস্থাপন করুন । নতুন কনফিগারেশন ফাইল/অবজেক্টটিতে আপনার অ্যাপ এবং Firebase প্রজেক্টের জন্য একটি বৈধ API কী থাকা উচিত।
আপনি যদি Cloud Storage for Firebase ইউআরএল ব্যবহার করে একটি মাল্টিমোডাল রিকোয়েস্ট পাঠানোর চেষ্টা করেন, তাহলে আপনি নিম্নলিখিত 400 এররটির সম্মুখীন হতে পারেন:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
এই ত্রুটিটি এমন একটি প্রজেক্টের কারণে ঘটে, যেখানে Vertex AI API সক্রিয় করার সময় প্রয়োজনীয় সার্ভিস এজেন্টগুলো সঠিকভাবে স্বয়ংক্রিয়ভাবে প্রোভিশন করা হয়নি। এটি কিছু প্রজেক্টের একটি পরিচিত সমস্যা, এবং আমরা এর একটি বৈশ্বিক সমাধান নিয়ে কাজ করছি।
আপনার প্রজেক্টটি ঠিক করতে এবং এই সার্ভিস এজেন্টগুলোকে সঠিকভাবে প্রোভিশন করার জন্য এখানে একটি সমাধান দেওয়া হলো, যাতে আপনি আপনার মাল্টিমোডাল রিকোয়েস্টগুলোতে Cloud Storage for Firebase ইউআরএল অন্তর্ভুক্ত করা শুরু করতে পারেন। আপনাকে অবশ্যই প্রজেক্টটির একজন ওনার (Owner) হতে হবে এবং আপনার প্রজেক্টের জন্য এই কাজগুলো শুধুমাত্র একবারই সম্পন্ন করতে হবে।
gcloud CLI ব্যবহার করে প্রবেশ ও প্রমাণীকরণ করুন।
এটি করার সবচেয়ে সহজ উপায় হলো Cloud Shell থেকে। Google Cloud ডকুমেন্টেশনে (Google Cloud documentation) আরও বিস্তারিত জানুন।অনুরোধ করা হলে, আপনার Firebase প্রোজেক্টে gcloud CLI চালানোর জন্য টার্মিনালে প্রদর্শিত নির্দেশাবলী অনুসরণ করুন।
আপনার ফায়ারবেস প্রজেক্ট আইডি প্রয়োজন হবে, যা আপনি Firebase কনসোলের ' সেটিংস'- এর শীর্ষে খুঁজে পাবেন।
নিম্নলিখিত কমান্ডটি চালিয়ে আপনার প্রোজেক্টে প্রয়োজনীয় সার্ভিস এজেন্টগুলো প্রোভিশন করুন:
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
সার্ভিস এজেন্টগুলো প্রস্তুত হয়েছে কিনা তা নিশ্চিত করতে কয়েক মিনিট অপেক্ষা করুন, এবং তারপর Cloud Storage for Firebase ইউআরএল (Cloud Storage for Firebase URL) সহ আপনার মাল্টিমোডাল অনুরোধটি পুনরায় পাঠানোর চেষ্টা করুন।
কয়েক মিনিট অপেক্ষা করার পরেও যদি আপনি এই ত্রুটিটি পান, তাহলে Firebase Support-এর সাথে যোগাযোগ করুন।
যদি আপনি একটি 403 এরর পান যেখানে লেখা থাকে Requests to this API firebasevertexai.googleapis.com ... are blocked. , তাহলে এর মানে সাধারণত এই যে, আপনার অ্যাপের Firebase কনফিগারেশনে থাকা API কী-তে এমন কিছু সীমাবদ্ধতা রয়েছে যা এটিকে প্রয়োজনীয় API কল করতে বাধা দেয়।
এটি ঠিক করতে, আপনাকে Google Cloud কনসোলে আপনার API কী-এর বিধিনিষেধ আপডেট করে প্রয়োজনীয় API অন্তর্ভুক্ত করতে হবে। Firebase AI Logic- এর জন্য, আপনাকে অবশ্যই নিশ্চিত করতে হবে যে Firebase AI Logic API ( firebasevertexai.googleapis.com ) সেই নির্বাচিত API-গুলোর তালিকায় অন্তর্ভুক্ত আছে, যেগুলোকে API কী ব্যবহার করে কল করা যায়।
এই ধাপগুলো অনুসরণ করুন:
Google Cloud কনসোলে, APIs & Services > Credentials প্যানেলটি খুলুন।
আপনার অ্যাপ্লিকেশনটি যে API কী ব্যবহার করার জন্য কনফিগার করা হয়েছে, সেটি নির্বাচন করুন (উদাহরণস্বরূপ, একটি iOS অ্যাপের জন্য "iOS কী")।
এপিআই কী সম্পাদনা (Edit API key) পৃষ্ঠায়, এপিআই সীমাবদ্ধতা (API restrictions ) বিভাগটি খুঁজুন।
নিশ্চিত করুন যে ‘Restrict key’ অপশনটি সিলেক্ট করা আছে। যদি তা না থাকে, তাহলে আপনার কী-টি আনরেস্ট্রিক্টেড, এবং সম্ভবত এটি ত্রুটির কারণ নয়।
নির্বাচিত এপিআই (Selected APIs) ড্রপ-ডাউন মেনুতে, Firebase AI Logic API-টি অনুসন্ধান করে নির্বাচন করুন, যাতে এটি এপিআই কী (API key) ব্যবহার করে কল করা যায় এমন নির্বাচিত এপিআই-এর তালিকায় যুক্ত হয়।
সংরক্ষণ করুন- এ ক্লিক করুন।
পরিবর্তনগুলো কার্যকর হতে পাঁচ মিনিট পর্যন্ত সময় লাগতে পারে।
যদি আপনি PERMISSION_DENIED: The caller does not have permission. লেখা একটি 403 এরর পান, তাহলে এর মানে সাধারণত এই যে, আপনার Firebase কনফিগারেশন ফাইল/অবজেক্টে থাকা API কী-টি অন্য কোনো Firebase প্রজেক্টের।
আপনার Firebase কনফিগারেশন ফাইল/অবজেক্টে তালিকাভুক্ত API কী-টি আপনার অ্যাপের API কী-এর সাথে মেলে কিনা তা যাচাই করুন। আপনি Google Cloud কনসোলের APIs & Services > Credentials প্যানেলে আপনার সমস্ত API কী দেখতে পারেন।
যদি দেখেন যে এগুলি মিলছে না, তাহলে একটি নতুন Firebase কনফিগারেশন ফাইল/অবজেক্ট সংগ্রহ করুন এবং আপনার অ্যাপে থাকা ফাইলটি প্রতিস্থাপন করুন । নতুন কনফিগারেশন ফাইল/অবজেক্টটিতে আপনার অ্যাপ এবং Firebase প্রজেক্টের জন্য একটি বৈধ API কী থাকা উচিত।
আপনি যদি Gemini Developer API ব্যবহার করার চেষ্টা করেন এবং Firebase AI Logic genai config not found লেখা একটি 404 এরর পান, তাহলে এর মানে সাধারণত এই যে, আপনার Firebase প্রোজেক্টে Firebase AI Logic ক্লায়েন্ট SDK-গুলোর সাথে ব্যবহারের জন্য কোনো বৈধ Gemini API কী নেই।
এই ত্রুটির সবচেয়ে সম্ভাব্য কারণগুলো হলো:
আপনি এখনও জেমিনি ডেভেলপার এপিআই- এর জন্য আপনার ফায়ারবেস প্রজেক্টটি সেট আপ করেননি।
কী করতে হবে:
Firebase কনসোলে, AI Services > AI Logic- এ যান। Get started-এ ক্লিক করুন, এবং তারপর Gemini Developer API নির্বাচন করুন। API-টি এনাবল করুন, এবং কনসোলটি আপনার প্রোজেক্টকে Gemini Developer API-এর জন্য সেট আপ করে দেবে। ওয়ার্কফ্লোটি সম্পন্ন করার পর, আপনার রিকোয়েস্টটি আবার চেষ্টা করুন।আপনি যদি খুব সম্প্রতি Firebase কনসোলে Firebase AI Logic সেটআপ প্রক্রিয়াটি সম্পন্ন করে থাকেন, তাহলে আপনার Gemini API key-টি হয়তো এখনও সব অঞ্চলের প্রয়োজনীয় ব্যাকএন্ড পরিষেবাগুলোর জন্য উপলব্ধ নাও হতে পারে।
কী করতে হবে:
কয়েক মিনিট অপেক্ষা করুন এবং তারপর আপনার অনুরোধটি আবার চেষ্টা করুন।আপনার Gemini API কী-টি সম্ভবত আপনার Firebase প্রজেক্ট থেকে মুছে গেছে।
কী করতে হবে:
Firebase AI Logic দ্বারা ব্যবহৃত Gemini API কী কীভাবে পরিবর্তন করতে হয় তা জানুন।
উদাহরণস্বরূপ: " Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3-pro-image-preview was not found or your project does not have access to it. Please ensure you are using a valid model version. "
এই ধরনের ত্রুটি হওয়ার কয়েকটি ভিন্ন কারণ থাকতে পারে।
অবৈধ মডেলের নাম
কারণ : আপনার দেওয়া মডেলের নামটি বৈধ নয়।
সমাধান : সমস্ত সমর্থিত এবং উপলব্ধ মডেলের তালিকার সাথে আপনার মডেলের নাম এবং মডেল সংস্করণটি মিলিয়ে দেখুন। মডেলের নামের অংশগুলো এবং তাদের ক্রম অবশ্যই যাচাই করে নেবেন। উদাহরণস্বরূপ:
- সর্বশেষ জেমিনি ৩.এক্স প্রো মডেলের নাম:
gemini-3.1-pro-preview(শুধুমাত্র প্রিভিউতে উপলব্ধ) - সর্বশেষ জেমিনি ৩.x ফ্ল্যাশ মডেলের নাম:
gemini-3.5-flash - সর্বশেষ জেমিনি ৩.এক্স ফ্ল্যাশ-লাইট মডেলের নাম:
gemini-3.1-flash-lite - সর্বশেষ জেমিনি ৩.এক্স প্রো ইমেজ (ওরফে 'ন্যানো ব্যানানা প্রো') মডেলের নাম:
gemini-3-pro-image-preview(শুধুমাত্র প্রিভিউতে উপলব্ধ) - সর্বশেষ জেমিনি ৩.এক্স ফ্ল্যাশ ইমেজ (ওরফে 'ন্যানো ব্যানানা ২') মডেলের নাম:
gemini-3.1-flash-image-preview(শুধুমাত্র প্রিভিউতে উপলব্ধ) - সর্বশেষ 'ন্যানো বানানা' মডেলের নাম:
gemini-2.5-flash-image
- সর্বশেষ জেমিনি ৩.এক্স প্রো মডেলের নাম:
অবৈধ অবস্থান (শুধুমাত্র Vertex AI Gemini API প্রোভাইডার ব্যবহার করার ক্ষেত্রে প্রযোজ্য)
কারণ : Vertex AI Gemini API ব্যবহার করে আপনার প্রতিটি অনুরোধে মডেলটি অ্যাক্সেস করার জন্য অবস্থান অন্তর্ভুক্ত করতে হবে। আপনার অনুরোধটি এমন কোনো অবস্থানে থাকা মডেল অ্যাক্সেস করার চেষ্টা করতে পারে যেখানে মডেলটি উপলব্ধ নেই।
সমাধান : নিশ্চিত করুন যে আপনার অনুরোধটি সেই মডেলটিকেই অ্যাক্সেস করার চেষ্টা করছে যেখানে এটি উপলব্ধ আছে।
Vertex AI Gemini API ব্যবহার করার সময়, Firebase AI Logic ডিফল্টরূপে
us-central1ব্যবহার করে। তবে, সব মডেলus-central1এ সমর্থিত নয়। এর মানে হলো, মডেলের উপর নির্ভর করে, ইনিশিয়ালাইজেশনের সময় আপনাকে স্পষ্টভাবে একটি নির্দিষ্ট লোকেশন সেট করতে হতে পারে।জেমিনি প্রিভিউ এবং এক্সপেরিমেন্টাল মডেল : লোকেশন
global-এ সেট করা আবশ্যক ( Live API মডেল ব্যতীত)। সমস্ত প্রিভিউ এবং এক্সপেরিমেন্টাল জেমিনি মডেল ( Live API মডেল ব্যতীত) শুধুমাত্রglobalলোকেশনেই উপলব্ধ।জেমিনি ৩.x মডেল : ফায়ারবেস এআই লজিক ব্যবহার করার সময় লোকেশন '
globalসেট করা আবশ্যক। ফায়ারবেস এআই লজিক এখনওusএবংeuলোকেশন সমর্থন করে না।জেমিনি ২.৫ মডেল : অবস্থান নির্ধারণ করা ঐচ্ছিক। আপনি যদি কোনো অবস্থান নির্দিষ্ট না করেন, তাহলে ডিফল্ট অবস্থান হবে
us-central1।Gemini Live API মডেল : অবস্থান নির্ধারণ করা ঐচ্ছিক। আপনি যদি কোনো অবস্থান নির্দিষ্ট না করেন, তাহলে ডিফল্ট অবস্থান হবে
us-central1। উল্লেখ্য যে,globalলোকেশন সমর্থিত নয় ।
মডেল অ্যাক্সেস করার অবস্থান কীভাবে নির্দিষ্ট করতে হয় সে সম্পর্কে আরও জানুন (কোড স্নিপেট সহ)।
429 এরর নির্দেশ করে যে আপনি হয় আপনার কোটা অতিক্রম করছেন অথবা আপনি যে মডেলটি অ্যাক্সেস করছেন তা অন্য ব্যবহারকারীদের অনুরোধের কারণে ওভারলোডেড হয়ে আছে।
কী পদক্ষেপ নিতে হবে তা নির্ভর করে আপনি Gemini Developer API নাকি Vertex AI Gemini API ব্যবহার করছেন তার উপর। কোটা এবং কীভাবে অতিরিক্ত কোটার জন্য অনুরোধ করতে হয় সে সম্পর্কে আরও তথ্যের জন্য, রেট লিমিট এবং কোটা দেখুন।
আপনি যদি Vertex AI Gemini API ব্যবহার করেন, তাহলে Google Cloud ডকুমেন্টেশনে এরর কোড 429 সম্পর্কে কিছু অতিরিক্ত প্রাসঙ্গিক তথ্য ও নির্দেশনা দেওয়া আছে।