আপনি Gemini API কল করার সময় উদ্ভূত সাধারণ সমস্যাগুলি নির্ণয় এবং সমাধান করতে সহায়তা করতে এই নির্দেশিকাটি ব্যবহার করুন৷ আপনি Gemini API ব্যাকএন্ড পরিষেবা বা ক্লায়েন্ট SDKs থেকে সমস্যার সম্মুখীন হতে পারেন৷ আমাদের ক্লায়েন্ট SDKগুলি নিম্নলিখিত সংগ্রহস্থলগুলিতে ওপেন সোর্স করা হয়:
- generative-ai-python
- generative-ai-js
- generative-ai-android
- generative-ai-swift
- generative-ai-dart
- generative-ai-go
আপনি যদি API কী সমস্যার সম্মুখীন হন, তাহলে নিশ্চিত করুন যে আপনি API কী সেটআপ গাইড অনুযায়ী আপনার API কী সঠিকভাবে সেট আপ করেছেন।
Gemini API ব্যাকএন্ড পরিষেবা ত্রুটি কোড
নিম্নলিখিত সারণীতে সাধারণ ব্যাকএন্ড ত্রুটি কোডগুলি তালিকাভুক্ত করা হয়েছে যা আপনি সম্মুখীন হতে পারেন, তাদের কারণ এবং সমস্যা সমাধানের পদক্ষেপগুলির ব্যাখ্যা সহ:
| HTTP কোড | স্ট্যাটাস | বর্ণনা | উদাহরণ | সমাধান |
| 400 | INVALID_ARGUMENT | অনুরোধের মূল অংশটি বিকৃত। | আপনার অনুরোধে একটি টাইপো বা অনুপস্থিত প্রয়োজনীয় ক্ষেত্র রয়েছে৷ | অনুরোধ বিন্যাস, উদাহরণ, এবং সমর্থিত সংস্করণের জন্য API রেফারেন্স পরীক্ষা করুন। একটি পুরানো এন্ডপয়েন্টের সাথে একটি নতুন API সংস্করণ থেকে বৈশিষ্ট্যগুলি ব্যবহার করা ত্রুটির কারণ হতে পারে৷ |
| 400 | FAILED_PRECONDITION | আপনার দেশে Gemini API বিনামূল্যের স্তর উপলব্ধ নয়৷ Google AI স্টুডিওতে আপনার প্রোজেক্টে বিলিং চালু করুন। | আপনি এমন একটি অঞ্চলে একটি অনুরোধ করছেন যেখানে বিনামূল্যের স্তর সমর্থিত নয় এবং আপনি Google AI স্টুডিওতে আপনার প্রকল্পে বিলিং সক্ষম করেননি৷ | Gemini API ব্যবহার করতে, আপনাকে Google AI Studio ব্যবহার করে একটি অর্থপ্রদানের পরিকল্পনা সেটআপ করতে হবে। |
| 403 | PERMISSION_DENIED | আপনার API কী এর প্রয়োজনীয় অনুমতি নেই। | আপনি ভুল API কী ব্যবহার করছেন; আপনি সঠিক প্রমাণীকরণের মাধ্যমে না গিয়ে একটি টিউন করা মডেল ব্যবহার করার চেষ্টা করছেন। | আপনার API কী সেট করা আছে এবং সঠিক অ্যাক্সেস আছে কিনা পরীক্ষা করুন। এবং টিউন করা মডেলগুলি ব্যবহার করার জন্য যথাযথ প্রমাণীকরণের মধ্য দিয়ে যেতে ভুলবেন না। |
| 404 | NOT_FOUND | অনুরোধ করা সম্পদ খুঁজে পাওয়া যায়নি. | আপনার অনুরোধে উল্লেখ করা একটি ছবি, অডিও বা ভিডিও ফাইল পাওয়া যায়নি। | আপনার অনুরোধের সমস্ত প্যারামিটার আপনার API সংস্করণের জন্য বৈধ কিনা তা পরীক্ষা করুন৷ |
| 429 | RESOURCE_EXHAUSTED | আপনি হারের সীমা অতিক্রম করেছেন। | আপনি ফ্রি টিয়ার জেমিনি API এর সাথে প্রতি মিনিটে অনেক বেশি অনুরোধ পাঠাচ্ছেন। | আপনি মডেলের হার সীমার মধ্যে আছেন তা নিশ্চিত করুন৷ প্রয়োজনে কোটা বৃদ্ধির অনুরোধ করুন । |
| 500 | অভ্যন্তরীণ | Google এর পক্ষ থেকে একটি অপ্রত্যাশিত ত্রুটি ঘটেছে৷ | আপনার ইনপুট প্রসঙ্গ খুব দীর্ঘ. | আপনার ইনপুট প্রসঙ্গ হ্রাস করুন বা অস্থায়ীভাবে অন্য মডেলে স্যুইচ করুন (যেমন জেমিনি 1.5 প্রো থেকে জেমিনি 1.5 ফ্ল্যাশ) এবং দেখুন এটি কাজ করে কিনা৷ অথবা একটু অপেক্ষা করুন এবং আপনার অনুরোধ পুনরায় চেষ্টা করুন. আবার চেষ্টা করার পরেও যদি সমস্যাটি থেকে যায়, অনুগ্রহ করে Google AI স্টুডিওতে প্রতিক্রিয়া পাঠান বোতাম ব্যবহার করে রিপোর্ট করুন। |
| 503 | অনুপলব্ধ | পরিষেবাটি সাময়িকভাবে ওভারলোড বা ডাউন হতে পারে। | পরিষেবাটি সাময়িকভাবে ক্ষমতার বাইরে চলে যাচ্ছে। | সাময়িকভাবে অন্য মডেলে (যেমন জেমিনি 1.5 প্রো থেকে জেমিনি 1.5 ফ্ল্যাশে) স্যুইচ করুন এবং দেখুন এটি কাজ করে কিনা। অথবা একটু অপেক্ষা করুন এবং আপনার অনুরোধ পুনরায় চেষ্টা করুন. আবার চেষ্টা করার পরেও যদি সমস্যাটি থেকে যায়, অনুগ্রহ করে Google AI স্টুডিওতে প্রতিক্রিয়া পাঠান বোতাম ব্যবহার করে রিপোর্ট করুন। |
| 504 | DEADLINE_EXCEEDED | পরিষেবাটি সময়সীমার মধ্যে প্রক্রিয়াকরণ শেষ করতে অক্ষম৷ | আপনার প্রম্পট (বা প্রসঙ্গ) সময়মত প্রক্রিয়া করার জন্য খুব বড়। | এই ত্রুটি এড়াতে আপনার ক্লায়েন্ট অনুরোধে একটি বড় 'টাইমআউট' সেট করুন। |
ক্লায়েন্ট SDK ত্রুটি কোড
মডেল প্যারামিটার ত্রুটির জন্য আপনার API কলগুলি পরীক্ষা করুন৷
নিশ্চিত করুন যে আপনার মডেল প্যারামিটারগুলি নিম্নলিখিত মানগুলির মধ্যে রয়েছে:
| মডেল প্যারামিটার | মান (পরিসীমা) |
| প্রার্থী গণনা | 1-8 (পূর্ণসংখ্যা) |
| তাপমাত্রা | 0.0-1.0 |
| সর্বোচ্চ আউটপুট টোকেন | আপনি যে মডেলটি ব্যবহার করছেন তার জন্য সর্বাধিক সংখ্যক টোকেন নির্ধারণ করতে get_model ( Python ) ব্যবহার করুন। |
| টপপি | 0.0-1.0 |
প্যারামিটার মান পরীক্ষা করার পাশাপাশি, নিশ্চিত করুন যে আপনি সঠিক API সংস্করণ (যেমন, /v1 বা /v1beta ) এবং মডেলটি ব্যবহার করছেন যা আপনার প্রয়োজনীয় বৈশিষ্ট্যগুলিকে সমর্থন করে৷ উদাহরণস্বরূপ, যদি একটি বৈশিষ্ট্য বিটা রিলিজে থাকে তবে এটি শুধুমাত্র /v1beta API সংস্করণে উপলব্ধ হবে৷
আপনার সঠিক মডেল আছে কিনা তা পরীক্ষা করুন
আপনি আমাদের মডেল পৃষ্ঠায় তালিকাভুক্ত একটি সমর্থিত মডেল ব্যবহার করছেন তা নিশ্চিত করুন।
নিরাপত্তা সমস্যা
আপনি যদি দেখেন যে আপনার API কলে একটি নিরাপত্তা সেটিং এর কারণে একটি প্রম্পট ব্লক করা হয়েছে, তাহলে আপনি API কলে যে ফিল্টারগুলি সেট করেছেন সেগুলির ক্ষেত্রে প্রম্পটটি পর্যালোচনা করুন৷
আপনি যদি BlockedReason.OTHER দেখতে পান, প্রশ্ন বা প্রতিক্রিয়া পরিষেবার শর্তাবলী লঙ্ঘন করতে পারে বা অন্যথায় অসমর্থিত হতে পারে।
আবৃত্তি সমস্যা
আপনি যদি দেখেন যে মডেলটি আবৃত্তির কারণে আউটপুট তৈরি করা বন্ধ করে দিয়েছে, এর মানে হল মডেল আউটপুট নির্দিষ্ট ডেটার অনুরূপ হতে পারে। এটি ঠিক করতে, প্রম্পট/প্রসঙ্গ যতটা সম্ভব অনন্য করার চেষ্টা করুন এবং উচ্চ তাপমাত্রা ব্যবহার করুন।
মডেল আউটপুট উন্নত
উচ্চ মানের মডেল আউটপুট জন্য, আরো কাঠামোগত প্রম্পট লেখার অন্বেষণ করুন. প্রম্পট ডিজাইন পৃষ্ঠার ভূমিকা আপনাকে শুরু করার জন্য কিছু মৌলিক ধারণা, কৌশল এবং সর্বোত্তম অনুশীলনের পরিচয় দেয়।
আপনার যদি ভাল ইনপুট/আউটপুট জোড়ার শত শত উদাহরণ থাকে, আপনি মডেল টিউনিংও বিবেচনা করতে পারেন।
টোকেন সীমা বুঝুন
টোকেন এবং তাদের সীমাগুলি কীভাবে গণনা করতে হয় তা আরও ভালভাবে বুঝতে আমাদের টোকেন গাইডটি পড়ুন।
পরিচিত সমস্যা
- API শুধুমাত্র কয়েকটি নির্বাচিত ভাষা সমর্থন করে। অসমর্থিত ভাষায় প্রম্পট জমা দেওয়া অপ্রত্যাশিত বা এমনকি অবরুদ্ধ প্রতিক্রিয়া তৈরি করতে পারে। আপডেটের জন্য উপলব্ধ ভাষা দেখুন।
একটি বাগ ফাইল করুন
আপনার যদি প্রশ্ন থাকে তবে Google AI বিকাশকারী ফোরামে আলোচনায় যোগ দিন।