আপনি Gemini API কল করার সময় উদ্ভূত সাধারণ সমস্যাগুলি নির্ণয় এবং সমাধান করতে সহায়তা করতে এই নির্দেশিকাটি ব্যবহার করুন৷ আপনি যদি API কী সমস্যার সম্মুখীন হন, তাহলে নিশ্চিত করুন যে আপনি API কী সেটআপ গাইড অনুযায়ী আপনার API কী সঠিকভাবে সেট আপ করেছেন।
ত্রুটি কোড
নিম্নলিখিত সারণীতে আপনি যে সাধারণ ত্রুটি কোডগুলির সম্মুখীন হতে পারেন তার কারণ এবং সমস্যা সমাধানের পদক্ষেপগুলির ব্যাখ্যা সহ তালিকাভুক্ত করে:
| HTTP কোড | স্ট্যাটাস | বর্ণনা | সমাধান |
| 400 | INVALID_ARGUMENT | অনুরোধের মূল অংশটি বিকৃত। | অনুরোধ বিন্যাস, উদাহরণ, এবং সমর্থিত সংস্করণের জন্য API রেফারেন্স পরীক্ষা করুন। একটি পুরানো এন্ডপয়েন্টের সাথে একটি নতুন API সংস্করণ থেকে বৈশিষ্ট্যগুলি ব্যবহার করা ত্রুটির কারণ হতে পারে৷ |
| 403 | PERMISSION_DENIED | আপনার API কী এর প্রয়োজনীয় অনুমতি নেই। | আপনার API কী সেট করা আছে এবং সঠিক অ্যাক্সেস আছে কিনা পরীক্ষা করুন। |
| 404 | NOT_FOUND | অনুরোধ করা সম্পদ খুঁজে পাওয়া যায়নি. | আপনার অনুরোধের সমস্ত প্যারামিটার আপনার API সংস্করণের জন্য বৈধ কিনা তা পরীক্ষা করুন৷ |
| 429 | RESOURCE_EXHAUSTED | আপনি হারের সীমা অতিক্রম করেছেন। | আপনি মডেলের হার সীমার মধ্যে আছেন তা নিশ্চিত করুন৷ প্রয়োজনে কোটা বৃদ্ধির অনুরোধ করুন । |
| 500 | অভ্যন্তরীণ | Google এর পক্ষ থেকে একটি অপ্রত্যাশিত ত্রুটি ঘটেছে৷ | একটু অপেক্ষা করুন এবং আপনার অনুরোধ পুনরায় চেষ্টা করুন. আবার চেষ্টা করার পরেও যদি সমস্যাটি থেকে যায়, অনুগ্রহ করে Google AI স্টুডিওতে প্রতিক্রিয়া পাঠান বোতাম ব্যবহার করে রিপোর্ট করুন। |
| 503 | অনুপলব্ধ | পরিষেবাটি সাময়িকভাবে ওভারলোড বা ডাউন হতে পারে। | একটু অপেক্ষা করুন এবং আপনার অনুরোধ পুনরায় চেষ্টা করুন. আবার চেষ্টা করার পরেও যদি সমস্যাটি থেকে যায়, অনুগ্রহ করে Google AI স্টুডিওতে প্রতিক্রিয়া পাঠান বোতাম ব্যবহার করে রিপোর্ট করুন। |
মডেল প্যারামিটার ত্রুটির জন্য আপনার API কলগুলি পরীক্ষা করুন৷
নিশ্চিত করুন যে আপনার মডেল প্যারামিটারগুলি নিম্নলিখিত মানগুলির মধ্যে রয়েছে:
| মডেল প্যারামিটার | মান (পরিসীমা) |
| প্রার্থী গণনা | 1-8 (পূর্ণসংখ্যা) |
| তাপমাত্রা | 0.0-1.0 |
| সর্বোচ্চ আউটপুট টোকেন | আপনি যে মডেলটি ব্যবহার করছেন তার জন্য সর্বাধিক সংখ্যক টোকেন নির্ধারণ করতে get_model ( Python ) ব্যবহার করুন। |
| টপপি | 0.0-1.0 |
প্যারামিটার মান পরীক্ষা করার পাশাপাশি, নিশ্চিত করুন যে আপনি সঠিক API সংস্করণ (যেমন, /v1 বা /v1beta ) এবং মডেলটি ব্যবহার করছেন যা আপনার প্রয়োজনীয় বৈশিষ্ট্যগুলিকে সমর্থন করে৷ উদাহরণস্বরূপ, যদি একটি বৈশিষ্ট্য বিটা রিলিজে থাকে তবে এটি শুধুমাত্র /v1beta API সংস্করণে উপলব্ধ হবে৷
আপনার সঠিক মডেল আছে কিনা তা পরীক্ষা করুন
আপনি একটি সমর্থিত মডেল ব্যবহার করছেন তা নিশ্চিত করুন। ব্যবহারের জন্য উপলব্ধ সমস্ত মডেল পেতে list_models ( Python ) ব্যবহার করুন।
নিরাপত্তা বিষয়
আপনি যদি দেখেন যে আপনার API কলে একটি নিরাপত্তা সেটিং এর কারণে একটি প্রম্পট ব্লক করা হয়েছে, তাহলে আপনি API কলে যে ফিল্টারগুলি সেট করেছেন সেগুলির ক্ষেত্রে প্রম্পটটি পর্যালোচনা করুন৷
আপনি যদি BlockedReason.OTHER দেখতে পান, প্রশ্ন বা প্রতিক্রিয়া পরিষেবার শর্তাবলী লঙ্ঘন করতে পারে বা অন্যথায় অসমর্থিত হতে পারে।
মডেল আউটপুট উন্নত
উচ্চ মানের মডেল আউটপুট জন্য, আরো কাঠামোগত প্রম্পট লেখার অন্বেষণ করুন. প্রম্পট ডিজাইন পৃষ্ঠার ভূমিকা আপনাকে শুরু করার জন্য কিছু মৌলিক ধারণা, কৌশল এবং সর্বোত্তম অনুশীলনের পরিচয় দেয়।
আপনার যদি ভাল ইনপুট/আউটপুট জোড়ার শত শত উদাহরণ থাকে, আপনি মডেল টিউনিংও বিবেচনা করতে পারেন।
টোকেন সীমা বুঝুন
ইনপুট এবং আউটপুট টোকেন সীমা সহ মডেল সম্পর্কে অতিরিক্ত মেটাডেটা পেতে ModelService API ব্যবহার করুন।
আপনার প্রম্পট দ্বারা ব্যবহৃত টোকেনগুলি পেতে, চ্যাট মডেলগুলির জন্য countMessageTokens এবং পাঠ্য মডেলগুলির জন্য countTextTokens ব্যবহার করুন৷
জ্ঞাত সমস্যা
- গুগল এআই স্টুডিওর জন্য মোবাইল সমর্থন: আপনি মোবাইলে ওয়েবসাইট খুলতে পারলেও, এটি ছোট পর্দার জন্য অপ্টিমাইজ করা হয়নি।
- API শুধুমাত্র ইংরেজি সমর্থন করে। বিভিন্ন ভাষায় প্রম্পট জমা দেওয়া অপ্রত্যাশিত বা এমনকি অবরুদ্ধ প্রতিক্রিয়া তৈরি করতে পারে। আপডেটের জন্য উপলব্ধ ভাষা দেখুন।
একটি বাগ ফাইল করুন
প্রশ্ন জিজ্ঞাসা করতে বা বৈশিষ্ট্য অনুরোধ বা বাগ জমা দিতে Github-এ একটি সমস্যা ফাইল করুন।