এই পৃষ্ঠায় জেমিনি এপিআই এবং ফায়ারবেস এআই লজিক এসডিকে-এর সাধারণ ত্রুটি কোডগুলোর সমাধান দেওয়া হয়েছে।
যদি আপনি 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.
এই ত্রুটিটি এমন একটি প্রজেক্টের কারণে ঘটে, যেখানে এজেন্ট প্ল্যাটফর্ম এপিআই (Agent Platform 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 কী থাকা উচিত।
যদি আপনি Firebase AI Logic genai config not found লেখা সহ একটি 404 এরর পান, তাহলে এর মানে সাধারণত এই যে, Firebase AI Logic- এর কোনো একটি সেটিং ভুলভাবে কনফিগার করা আছে অথবা সেটি অনুপস্থিত।
এই ত্রুটির সবচেয়ে সম্ভাব্য কারণগুলো হলো:
আপনি এখনও আপনার Firebase প্রজেক্টটি Gemini API প্রোভাইডারের জন্য সেট আপ করেননি।
কী করতে হবে:
Firebase কনসোলে, AI Services > AI Logic- এ যান। Get started-এ ক্লিক করুন, এবং তারপর আপনার পছন্দের Gemini API প্রোভাইডারটি নির্বাচন করুন। API-টি এনাবল করুন, এবং Firebase সেই প্রোভাইডারের জন্য আপনার প্রজেক্টটি সেট আপ করে দেবে। ওয়ার্কফ্লোটি সম্পন্ন করার পর, আপনার রিকোয়েস্টটি আবার চেষ্টা করুন।আপনি যদি খুব সম্প্রতি Firebase কনসোলে Firebase AI Logic সেটআপ প্রক্রিয়াটি সম্পন্ন করে থাকেন, তাহলে Firebase AI Logic- এর কনফিগারেশনটি হয়তো এখনও সমস্ত প্রযোজ্য অঞ্চলের প্রয়োজনীয় সকল ব্যাকএন্ড সার্ভিসের জন্য উপলব্ধ নাও হতে পারে।
কী করতে হবে:
কয়েক মিনিট অপেক্ষা করুন এবং তারপর আপনার অনুরোধটি আবার চেষ্টা করুন।
উদাহরণস্বরূপ: " Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3.1-pro-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.6-flash - সর্বশেষ জেমিনি ৩.এক্স ফ্ল্যাশ-লাইট মডেলের নাম:
gemini-3.5-flash-lite - সর্বশেষ জেমিনি ৩.এক্স প্রো ইমেজ (ওরফে 'ন্যানো ব্যানানা প্রো') মডেলের নাম:
gemini-3-pro-image - সর্বশেষ জেমিনি ৩.এক্স ফ্ল্যাশ ইমেজ (ওরফে 'ন্যানো ব্যানানা ২') মডেলের নাম:
gemini-3.1-flash-image - সর্বশেষ জেমিনি ৩.এক্স ফ্ল্যাশ-লাইট ইমেজ (ওরফে 'ন্যানো ব্যানানা ২ লাইট') মডেলের নাম:
gemini-3.1-flash-lite-image - সর্বশেষ জেমিনি ২.৫ ফ্ল্যাশ ইমেজ (ওরফে 'ন্যানো ব্যানানা') মডেলের নাম:
gemini-2.5-flash-image
- সর্বশেষ জেমিনি ৩.এক্স প্রো মডেলের নাম:
অবৈধ অবস্থান (শুধুমাত্র এজেন্ট প্ল্যাটফর্ম জেমিনি এপিআই (পূর্বে ভার্টেক্স এআই) প্রদানকারী ব্যবহার করার ক্ষেত্রে প্রযোজ্য)
কারণ : আপনার অনুরোধটি এমন কোনো অবস্থানে থাকা একটি মডেল অ্যাক্সেস করার চেষ্টা করছে যেখানে মডেলটি উপলব্ধ নেই।
সমাধান : নিশ্চিত করুন যে আপনার অনুরোধটি সেই মডেলটিকেই অ্যাক্সেস করার চেষ্টা করছে যেখানে এটি উপলব্ধ আছে।
এজেন্ট প্ল্যাটফর্ম জেমিনি এপিআই (পূর্বে ভার্টেক্স এআই) ব্যবহার করার সময়, আপনি ঐচ্ছিকভাবে ইনিশিয়ালাইজেশনের সময় মডেলটি অ্যাক্সেস করার জন্য একটি অবস্থান নির্দিষ্ট করতে পারেন। যদি আপনি কোনো অবস্থান নির্দিষ্ট না করেন, তাহলে ফায়ারবেস এআই লজিক ডিফল্টরূপে নিম্নলিখিত অবস্থানগুলি ব্যবহার করে:
- "এজেন্ট প্ল্যাটফর্ম" প্রারম্ভিক সিনট্যাক্স ব্যবহার করার সময়:
global - পুরোনো "Vertex AI" প্রারম্ভিক সিনট্যাক্স ব্যবহার করার সময়:
us-central1
তবে, সব মডেল এই ডিফল্ট অবস্থানগুলিতে সমর্থিত নয়। এর মানে হলো, মডেলের উপর নির্ভর করে, ইনিশিয়ালাইজেশনের সময় একটি নির্দিষ্ট অবস্থান স্পষ্টভাবে সেট করার প্রয়োজন হতে পারে।
জেমিনি প্রিভিউ এবং পরীক্ষামূলক মডেল : শুধুমাত্র
globalলোকেশনে উপলব্ধ ( Live API মডেলগুলি ছাড়া - নিচে দেখুন)।জেমিনি ৩.x মডেল : ফায়ারবেস এআই লজিক ব্যবহার করার সময় শুধুমাত্র
globalলোকেশনে উপলব্ধ। ফায়ারবেস এআই লজিক এখনওusএবংeuলোকেশন সমর্থন করে না।জেমিনি ২.৫ মডেল : অনেক স্থানে পাওয়া যায় ।
Gemini Live API মডেল : শুধুমাত্র
us-central1লোকেশনে উপলব্ধ।globalলোকেশন সমর্থিত নয় ।
- "এজেন্ট প্ল্যাটফর্ম" প্রারম্ভিক সিনট্যাক্স ব্যবহার করার সময়:
মডেল অ্যাক্সেস করার অবস্থান কীভাবে নির্দিষ্ট করতে হয় সে সম্পর্কে আরও জানুন (কোড স্নিপেট সহ)।
429 এরর নির্দেশ করে যে আপনি হয় আপনার কোটা অতিক্রম করছেন অথবা আপনি যে মডেলটি অ্যাক্সেস করছেন তা অন্য ব্যবহারকারীদের অনুরোধের কারণে ওভারলোডেড হয়ে আছে।
কী পদক্ষেপ নিতে হবে তা নির্ভর করে আপনি জেমিনি ডেভেলপার এপিআই (Gemini Developer API) নাকি এজেন্ট প্ল্যাটফর্ম জেমিনি এপিআই (Agent Platform Gemini API) (পূর্বের ভার্টেক্স এআই) ব্যবহার করছেন তার উপর। কোটা এবং কীভাবে অতিরিক্ত কোটার জন্য অনুরোধ করতে হয় সে সম্পর্কে আরও তথ্যের জন্য, রেট লিমিট এবং কোটা (Rate limits and quotas) দেখুন।
আপনি যদি এজেন্ট প্ল্যাটফর্ম জেমিনি এপিআই (পূর্বের ভার্টেক্স এআই) ব্যবহার করেন, তাহলে Google Cloud ডকুমেন্টেশনে এরর কোড ৪২৯ সম্পর্কে কিছু অতিরিক্ত প্রাসঙ্গিক তথ্য ও নির্দেশনা দেওয়া আছে।