এই পৃষ্ঠায় জেমিনি এপিআই এবং ফায়ারবেস এআই লজিক এসডিকে-এর সাধারণ ত্রুটি কোডগুলোর সমাধান দেওয়া হয়েছে।
যদি আপনি 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 কনসোলে, Firebase 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 প্রিভিউ মডেলটির নাম হলো
gemini-3.1-pro-preview। - Gemini 3 Flash preview মডেলটির নাম হলো
gemini-3-flash-preview। - 'Nano Banana Pro' প্রিভিউ মডেলটির নাম হলো
gemini-3-pro-image-preview। - 'ন্যানো ব্যানানা ২' প্রিভিউ মডেলটির নাম হলো
gemini-3.1-flash-image-preview। - 'ন্যানো ব্যানানা' মডেলটির নাম হলো
gemini-2.5-flash-image।
- Gemini 3.1 Pro প্রিভিউ মডেলটির নাম হলো
অবৈধ অবস্থান (শুধুমাত্র Vertex AI Gemini API প্রোভাইডার এবং একটি প্রিভিউ বা পরীক্ষামূলক মডেল ব্যবহার করার ক্ষেত্রে প্রযোজ্য)
কারণ : আপনি কোনো মডেলের প্রিভিউ বা পরীক্ষামূলক সংস্করণ ব্যবহার করছেন (উদাহরণস্বরূপ,
gemini-3.1-pro-previewএবংgemini-3.1-flash-image-preview), এবং আপনি এরglobalলোকেশন নির্দিষ্ট করেননি।আপনি যদি Vertex AI Gemini API ব্যবহার করেন, তাহলে সমস্ত প্রিভিউ এবং পরীক্ষামূলক Gemini মডেল (Gemini Live মডেল ব্যতীত) শুধুমাত্র
globalলোকেশনেই উপলব্ধ থাকবে। তবে, যেহেতু Firebase AI Logic ডিফল্টরূপেus-central1লোকেশনের পরিবর্তে, এই প্রিভিউ এবং পরীক্ষামূলক জেমিনি মডেলগুলি ব্যবহার করার সময় আপনার কোডে Vertex AI Gemini API ব্যাকএন্ড পরিষেবা ইনিশিয়ালাইজ করার সময় আপনাকে অবশ্যইglobalলোকেশনটি স্পষ্টভাবে উল্লেখ করতে হবে।সমাধান : যখন আপনি Vertex AI Gemini API পরিষেবাটি চালু করবেন, তখন ‘location
globalনির্দিষ্ট করুন। মডেল অ্যাক্সেস করার জন্য কীভাবে অবস্থান নির্দিষ্ট করতে হয় সে সম্পর্কে আরও জানুন (কোড স্নিপেট সহ)।
অবৈধ অবস্থান (শুধুমাত্র Vertex AI Gemini API প্রোভাইডার ব্যবহার করার ক্ষেত্রে প্রযোজ্য)
কারণ : আপনি এমন একটি মডেল ব্যবহার করছেন যা আপনি যেখান থেকে এটি অ্যাক্সেস করার চেষ্টা করছেন, সেই স্থানে সমর্থিত নয়।
আপনি যদি Vertex AI Gemini API ব্যবহার করেন, তাহলে কিছু মডেল শুধুমাত্র নির্দিষ্ট কিছু স্থানেই পাওয়া যায় । উদাহরণস্বরূপ (তবে এটিই সব উদাহরণ নয়):
- ইমেজেন মডেলগুলো
globalলোকেশনে সমর্থিত নয় । - Gemini Live API মডেলগুলি (যেমন
gemini-2.0-flash-live-preview-04-09) শুধুমাত্র সমর্থিতus-central1অবস্থান। - জেমিনি ২.৫ মডেলগুলো (যেমন
gemini-2.5-pro) শুধুমাত্রglobalলোকেশন, ইউএস লোকেশন এবং কিছু ইউরোপীয় লোকেশনে পাওয়া যায় (এবং আপনার প্রোজেক্টে বিশেষ অপশন থাকলে কখনও কখনও অন্যান্য লোকেশনেও পাওয়া যেতে পারে)।
- ইমেজেন মডেলগুলো
সমাধান : যখন আপনি Vertex AI Gemini API পরিষেবাটি চালু করবেন, তখন নিশ্চিত করুন যে আপনি যে মডেলটি ব্যবহার করছেন তার জন্য একটি সমর্থিত অবস্থান নির্দিষ্ট করেছেন। মডেল অ্যাক্সেস করার জন্য অবস্থান কীভাবে নির্দিষ্ট করতে হয় (কোড স্নিপেট সহ) এবং মডেলগুলির জন্য সমর্থিত অবস্থানগুলি সম্পর্কে আরও জানুন।
মনে রাখবেন যে Firebase AI Logic ডিফল্টরূপে
us-central1অবস্থান।
429 এরর নির্দেশ করে যে আপনি হয় আপনার কোটা অতিক্রম করছেন অথবা আপনি যে মডেলটি অ্যাক্সেস করছেন তা অন্য ব্যবহারকারীদের অনুরোধের কারণে ওভারলোডেড হয়ে আছে।
কী পদক্ষেপ নিতে হবে তা নির্ভর করে আপনি Gemini Developer API নাকি Vertex AI Gemini API ব্যবহার করছেন তার উপর। কোটা এবং কীভাবে অতিরিক্ত কোটার জন্য অনুরোধ করতে হয় সে সম্পর্কে আরও তথ্যের জন্য, রেট লিমিট এবং কোটা দেখুন।
আপনি যদি Vertex AI Gemini API ব্যবহার করেন, তাহলে Google Cloud ডকুমেন্টেশনে এরর কোড 429 সম্পর্কে কিছু অতিরিক্ত প্রাসঙ্গিক তথ্য ও নির্দেশনা দেওয়া আছে।