সমস্যা সমাধানের গাইড

আপনি Gemini API কল করার সময় উদ্ভূত সাধারণ সমস্যাগুলি নির্ণয় এবং সমাধান করতে সহায়তা করতে এই নির্দেশিকাটি ব্যবহার করুন৷ আপনি Gemini API ব্যাকএন্ড পরিষেবা বা ক্লায়েন্ট SDKs থেকে সমস্যার সম্মুখীন হতে পারেন৷ আমাদের ক্লায়েন্ট SDKগুলি নিম্নলিখিত সংগ্রহস্থলগুলিতে ওপেন সোর্স করা হয়:

আপনি যদি 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 পরিষেবাটি সময়সীমার মধ্যে প্রক্রিয়াকরণ শেষ করতে অক্ষম৷ আপনার প্রম্পট (বা প্রসঙ্গ) সময়মত প্রক্রিয়া করার জন্য খুব বড়। এই ত্রুটি এড়াতে আপনার ক্লায়েন্ট অনুরোধে একটি বড় 'টাইমআউট' সেট করুন।

মডেল প্যারামিটার ত্রুটির জন্য আপনার API কলগুলি পরীক্ষা করুন৷

আপনার মডেল প্যারামিটারগুলি নিম্নলিখিত মানগুলির মধ্যে রয়েছে তা যাচাই করুন:

মডেল প্যারামিটার মান (পরিসীমা)
প্রার্থী গণনা 1-8 (পূর্ণসংখ্যা)
তাপমাত্রা 0.0-1.0
সর্বোচ্চ আউটপুট টোকেন আপনি যে মডেলটি ব্যবহার করছেন তার জন্য সর্বাধিক সংখ্যক টোকেন নির্ধারণ করতে get_model ( Python ) ব্যবহার করুন।
টপপি 0.0-1.0

প্যারামিটার মান পরীক্ষা করার পাশাপাশি, নিশ্চিত করুন যে আপনি সঠিক API সংস্করণ (যেমন, /v1 বা /v1beta ) এবং মডেলটি ব্যবহার করছেন যা আপনার প্রয়োজনীয় বৈশিষ্ট্যগুলিকে সমর্থন করে৷ উদাহরণস্বরূপ, যদি একটি বৈশিষ্ট্য বিটা রিলিজে থাকে তবে এটি শুধুমাত্র /v1beta API সংস্করণে উপলব্ধ হবে৷

আপনার সঠিক মডেল আছে কিনা তা পরীক্ষা করুন

আপনি আমাদের মডেল পৃষ্ঠায় তালিকাভুক্ত একটি সমর্থিত মডেল ব্যবহার করছেন তা যাচাই করুন।

2.5 মডেলের সাথে উচ্চতর বিলম্ব বা টোকেন ব্যবহার

আপনি যদি 2.5 ফ্ল্যাশ এবং প্রো মডেলগুলির সাথে উচ্চতর লেটেন্সি বা টোকেন ব্যবহার পর্যবেক্ষণ করেন, তবে এটি হতে পারে কারণ তারা চিন্তাভাবনা নিয়ে আসে গুণমান উন্নত করার জন্য ডিফল্টরূপে সক্ষম করা থাকে ৷ আপনি যদি গতিকে অগ্রাধিকার দেন বা খরচ কমাতে চান, তাহলে আপনি চিন্তাভাবনা সামঞ্জস্য বা অক্ষম করতে পারেন।

নির্দেশিকা এবং নমুনা কোডের জন্য চিন্তা পৃষ্ঠা পড়ুন।

নিরাপত্তা সমস্যা

আপনি যদি দেখেন যে আপনার API কলে একটি নিরাপত্তা সেটিং এর কারণে একটি প্রম্পট ব্লক করা হয়েছে, তাহলে আপনি API কলে যে ফিল্টারগুলি সেট করেছেন সেগুলির ক্ষেত্রে প্রম্পটটি পর্যালোচনা করুন৷

আপনি যদি BlockedReason.OTHER দেখতে পান, প্রশ্ন বা প্রতিক্রিয়া পরিষেবার শর্তাবলী লঙ্ঘন করতে পারে বা অন্যথায় অসমর্থিত হতে পারে।

আবৃত্তি সমস্যা

আপনি যদি দেখেন যে মডেলটি আবৃত্তির কারণে আউটপুট তৈরি করা বন্ধ করে দিয়েছে, এর মানে হল মডেল আউটপুট নির্দিষ্ট ডেটার অনুরূপ হতে পারে। এটি ঠিক করতে, প্রম্পট/প্রসঙ্গ যতটা সম্ভব অনন্য করার চেষ্টা করুন এবং উচ্চ তাপমাত্রা ব্যবহার করুন।

পুনরাবৃত্তিমূলক টোকেন সমস্যা

আপনি যদি বারবার আউটপুট টোকেন দেখতে পান তবে সেগুলি কমাতে বা দূর করতে সাহায্য করার জন্য নিম্নলিখিত পরামর্শগুলি চেষ্টা করুন৷

বর্ণনা কারণ প্রস্তাবিত সমাধান
মার্কডাউন টেবিলে বারবার হাইফেন এটি ঘটতে পারে যখন টেবিলের বিষয়বস্তু দীর্ঘ হয় যখন মডেলটি একটি দৃশ্যমানভাবে সারিবদ্ধ মার্কডাউন টেবিল তৈরি করার চেষ্টা করে। যাইহোক, সঠিক রেন্ডারিংয়ের জন্য মার্কডাউনে সারিবদ্ধকরণ প্রয়োজনীয় নয়।

মার্কডাউন টেবিল তৈরি করার জন্য মডেল নির্দিষ্ট নির্দেশিকা দিতে আপনার প্রম্পটে নির্দেশাবলী যোগ করুন। এই নির্দেশিকা অনুসরণ করে এমন উদাহরণ প্রদান করুন। আপনি তাপমাত্রা সামঞ্জস্য করার চেষ্টা করতে পারেন। মার্কডাউন টেবিলের মতো কোড বা খুব কাঠামোগত আউটপুট তৈরি করার জন্য, উচ্চ তাপমাত্রা আরও ভাল কাজ করতে দেখা গেছে (>= 0.8)।

নিম্নলিখিত নির্দেশিকাগুলির একটি উদাহরণ সেট আপনি এই সমস্যাটি প্রতিরোধ করতে আপনার প্রম্পটে যোগ করতে পারেন:

          # Markdown Table Format
          
          * Separator line: Markdown tables must include a separator line below
            the header row. The separator line must use only 3 hyphens per
            column, for example: |---|---|---|. Using more hypens like
            ----, -----, ------ can result in errors. Always
            use |:---|, |---:|, or |---| in these separator strings.

            For example:

            | Date | Description | Attendees |
            |---|---|---|
            | 2024-10-26 | Annual Conference | 500 |
            | 2025-01-15 | Q1 Planning Session | 25 |

          * Alignment: Do not align columns. Always use |---|.
            For three columns, use |---|---|---| as the separator line.
            For four columns use |---|---|---|---| and so on.

          * Conciseness: Keep cell content brief and to the point.

          * Never pad column headers or other cells with lots of spaces to
            match with width of other content. Only a single space on each side
            is needed. For example, always do "| column name |" instead of
            "| column name                |". Extra spaces are wasteful.
            A markdown renderer will automatically take care displaying
            the content in a visually appealing form.
মার্কডাউন টেবিলে বারবার টোকেন পুনরাবৃত্তি হাইফেনের মতো, এটি ঘটে যখন মডেলটি টেবিলের বিষয়বস্তুকে দৃশ্যমানভাবে সারিবদ্ধ করার চেষ্টা করে। সঠিক রেন্ডারিংয়ের জন্য মার্কডাউনে সারিবদ্ধকরণের প্রয়োজন নেই।
  • আপনার সিস্টেম প্রম্পটে নিম্নলিখিত মত নির্দেশাবলী যোগ করার চেষ্টা করুন: 
                FOR TABLE HEADINGS, IMMEDIATELY ADD ' |' AFTER THE TABLE HEADING.
  • তাপমাত্রা সামঞ্জস্য করার চেষ্টা করুন। উচ্চ তাপমাত্রা (>= 0.8) সাধারণত আউটপুটে পুনরাবৃত্তি বা নকল দূর করতে সাহায্য করে।
স্ট্রাকচার্ড আউটপুটে পুনরাবৃত্তি করা নতুন লাইন ( \n ) যখন মডেল ইনপুটে ইউনিকোড বা escape ক্রম থাকে যেমন \u বা \t , এটি বারবার নতুন লাইনের দিকে নিয়ে যেতে পারে।
  • আপনার প্রম্পটে UTF-8 অক্ষর দিয়ে নিষিদ্ধ এস্কেপ সিকোয়েন্সগুলি পরীক্ষা করুন এবং প্রতিস্থাপন করুন। উদাহরণস্বরূপ, আপনার JSON উদাহরণে \u এস্কেপ সিকোয়েন্স মডেলটিকে তার আউটপুটেও ব্যবহার করতে পারে।
  • অনুমোদিত পালানোর বিষয়ে মডেলকে নির্দেশ দিন। এই মত একটি সিস্টেম নির্দেশ যোগ করুন: 
                In quoted strings, the only allowed escape sequences are \\, \n, and \". Instead of \u escapes, use UTF-8.
স্ট্রাকচার্ড আউটপুট ব্যবহার করে বারবার লেখা যখন মডেল আউটপুট ক্ষেত্রগুলির জন্য সংজ্ঞায়িত স্ট্রাকচার্ড স্কিমার চেয়ে আলাদা ক্রম থাকে, তখন এটি পুনরাবৃত্তি পাঠ্য হতে পারে।
  • আপনার প্রম্পটে ক্ষেত্রের ক্রম উল্লেখ করবেন না।
  • সমস্ত আউটপুট ক্ষেত্র প্রয়োজনীয় করুন।
পুনরাবৃত্তি টুল কলিং এটি ঘটতে পারে যদি মডেলটি পূর্ববর্তী চিন্তার প্রেক্ষাপট হারিয়ে ফেলে এবং/অথবা একটি অনুপলব্ধ এন্ডপয়েন্ট কল করে যা এটি করতে বাধ্য হয়। মডেলটিকে তার চিন্তা প্রক্রিয়ার মধ্যে রাষ্ট্র বজায় রাখার নির্দেশ দিন। আপনার সিস্টেম নির্দেশাবলীর শেষে এটি যোগ করুন: 
        When thinking silently: ALWAYS start the thought with a brief
        (one sentence) recap of the current progress on the task. In
        particular, consider whether the task is already done.
পুনরাবৃত্তিমূলক পাঠ্য যা কাঠামোগত আউটপুটের অংশ নয় এটি ঘটতে পারে যদি মডেলটি এমন একটি অনুরোধে আটকে যায় যা এটি সমাধান করতে পারে না।
  • চিন্তাভাবনা চালু থাকলে, নির্দেশাবলীতে একটি সমস্যার মধ্য দিয়ে কীভাবে চিন্তা করা যায় তার জন্য স্পষ্ট আদেশ দেওয়া এড়িয়ে চলুন। শুধু চূড়ান্ত আউটপুট জন্য জিজ্ঞাসা করুন.
  • একটি উচ্চ তাপমাত্রা চেষ্টা করুন >= 0.8।
  • "সংক্ষিপ্ত হোন", "নিজেকে পুনরাবৃত্তি করবেন না" বা "একবার উত্তর দিন" এর মতো নির্দেশাবলী যোগ করুন।

মডেল আউটপুট উন্নত

উচ্চ মানের মডেল আউটপুট জন্য, আরো কাঠামোগত প্রম্পট লেখার অন্বেষণ করুন. প্রম্পট ইঞ্জিনিয়ারিং গাইড পৃষ্ঠাটি আপনাকে শুরু করার জন্য কিছু মৌলিক ধারণা, কৌশল এবং সর্বোত্তম অনুশীলনের পরিচয় দেয়।

আপনার যদি ভাল ইনপুট/আউটপুট জোড়ার শত শত উদাহরণ থাকে, আপনি মডেল টিউনিংও বিবেচনা করতে পারেন।

টোকেন সীমা বুঝুন

টোকেন এবং তাদের সীমা কিভাবে গণনা করতে হয় তা আরও ভালভাবে বুঝতে আমাদের টোকেন গাইড পড়ুন।

পরিচিত সমস্যা

  • API শুধুমাত্র কয়েকটি নির্বাচিত ভাষা সমর্থন করে। অসমর্থিত ভাষায় প্রম্পট জমা দেওয়া অপ্রত্যাশিত বা এমনকি অবরুদ্ধ প্রতিক্রিয়া তৈরি করতে পারে। আপডেটের জন্য উপলব্ধ ভাষা দেখুন।

একটি বাগ ফাইল করুন

আপনার যদি প্রশ্ন থাকে তবে Google AI বিকাশকারী ফোরামে আলোচনায় যোগ দিন।