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

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

যদি আপনি API কী সমস্যার সম্মুখীন হন, তাহলে যাচাই করুন যে আপনি API কী সেটআপ গাইড অনুসারে আপনার API কী সঠিকভাবে সেট আপ করেছেন।

জেমিনি এপিআই ব্যাকএন্ড পরিষেবা ত্রুটি কোডগুলি

নিম্নলিখিত টেবিলে আপনার সম্মুখীন হতে পারে এমন সাধারণ ব্যাকএন্ড ত্রুটি কোডগুলির তালিকা রয়েছে, সাথে তাদের কারণ এবং সমস্যা সমাধানের পদক্ষেপগুলির ব্যাখ্যাও রয়েছে:

HTTP কোড অবস্থা বিবরণ উদাহরণ সমাধান
৪০০ INVALID_যুক্তি অনুরোধের মূল অংশটি ত্রুটিপূর্ণ। আপনার অনুরোধে একটি টাইপিং ভুল আছে, অথবা একটি প্রয়োজনীয় ক্ষেত্র অনুপস্থিত। অনুরোধের ফর্ম্যাট, উদাহরণ এবং সমর্থিত সংস্করণের জন্য API রেফারেন্স পরীক্ষা করুন। পুরনো এন্ডপয়েন্ট সহ নতুন API সংস্করণের বৈশিষ্ট্যগুলি ব্যবহার করলে ত্রুটি হতে পারে।
৪০০ ব্যর্থ_পূর্ববর্তীতা আপনার দেশে Gemini API ফ্রি টিয়ার উপলব্ধ নেই। অনুগ্রহ করে Google AI স্টুডিওতে আপনার প্রকল্পের বিলিং সক্ষম করুন। আপনি এমন একটি অঞ্চলে একটি অনুরোধ করছেন যেখানে ফ্রি টিয়ার সমর্থিত নয়, এবং আপনি Google AI স্টুডিওতে আপনার প্রকল্পে বিলিং সক্ষম করেননি। জেমিনি এপিআই ব্যবহার করার জন্য, আপনাকে গুগল এআই স্টুডিও ব্যবহার করে একটি পেইড প্ল্যান সেটআপ করতে হবে।
৪০৩ অনুমতি বাতিল করা হয়েছে আপনার API কী-তে প্রয়োজনীয় অনুমতি নেই। আপনি ভুল API কী ব্যবহার করছেন; আপনি সঠিক প্রমাণীকরণ ছাড়াই একটি টিউন করা মডেল ব্যবহার করার চেষ্টা করছেন। আপনার API কী সেট করা আছে কিনা এবং সঠিক অ্যাক্সেস আছে কিনা তা পরীক্ষা করুন। এবং টিউন করা মডেলগুলি ব্যবহার করার জন্য সঠিক প্রমাণীকরণের মাধ্যমে যেতে ভুলবেন না।
৪০৪ খুঁজে পাওয়া যায়নি অনুরোধ করা রিসোর্সটি পাওয়া যায়নি। আপনার অনুরোধে উল্লেখিত কোনও ছবি, অডিও, অথবা ভিডিও ফাইল পাওয়া যায়নি। আপনার অনুরোধের সমস্ত প্যারামিটার আপনার API সংস্করণের জন্য বৈধ কিনা তা পরীক্ষা করুন।
৪২৯ রিসোর্স_ক্লান্ত তুমি হারের সীমা অতিক্রম করেছ। ফ্রি টিয়ার জেমিনি এপিআই ব্যবহার করে আপনি প্রতি মিনিটে অনেক বেশি অনুরোধ পাঠাচ্ছেন। আপনি মডেলের রেট সীমার মধ্যে আছেন কিনা তা যাচাই করুন। প্রয়োজনে কোটা বৃদ্ধির অনুরোধ করুন
৫০০ অভ্যন্তরীণ গুগলের পক্ষ থেকে একটি অপ্রত্যাশিত ত্রুটি ঘটেছে। আপনার ইনপুট প্রসঙ্গটি খুব দীর্ঘ। আপনার ইনপুট কনটেক্সট কমিয়ে দিন অথবা অস্থায়ীভাবে অন্য মডেলে স্যুইচ করুন (যেমন জেমিনি ১.৫ প্রো থেকে জেমিনি ১.৫ ফ্ল্যাশে) এবং দেখুন এটি কাজ করে কিনা। অথবা কিছুক্ষণ অপেক্ষা করুন এবং আপনার অনুরোধটি পুনরায় চেষ্টা করুন। পুনরায় চেষ্টা করার পরেও যদি সমস্যাটি থেকে যায়, তাহলে অনুগ্রহ করে গুগল এআই স্টুডিওতে " প্রতিক্রিয়া পাঠান" বোতামটি ব্যবহার করে রিপোর্ট করুন।
৫০৩ অনুপলব্ধ পরিষেবাটি সাময়িকভাবে ওভারলোড বা ডাউন হতে পারে। পরিষেবাটি সাময়িকভাবে শেষ হয়ে যাচ্ছে। সাময়িকভাবে অন্য মডেলে স্যুইচ করুন (যেমন Gemini 1.5 Pro থেকে Gemini 1.5 Flash) এবং দেখুন এটি কাজ করে কিনা। অথবা কিছুক্ষণ অপেক্ষা করুন এবং আপনার অনুরোধটি পুনরায় চেষ্টা করুন। পুনরায় চেষ্টা করার পরেও যদি সমস্যাটি থেকে যায়, তাহলে অনুগ্রহ করে Google AI Studio-তে "প্রতিক্রিয়া পাঠান" বোতামটি ব্যবহার করে এটি রিপোর্ট করুন।
৫০৪ শেষ তারিখ অতিক্রম করেছে পরিষেবাটি নির্ধারিত সময়ের মধ্যে প্রক্রিয়াকরণ শেষ করতে পারছে না। আপনার প্রম্পট (অথবা প্রসঙ্গ) এত বড় যে সময়মতো প্রক্রিয়া করা যাচ্ছে না। এই ত্রুটি এড়াতে আপনার ক্লায়েন্ট অনুরোধে একটি বৃহত্তর 'টাইমআউট' সেট করুন।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

মার্কডাউন টেবিল তৈরির জন্য মডেল নির্দিষ্ট নির্দেশিকা দেওয়ার জন্য আপনার প্রম্পটে নির্দেশিকা যোগ করুন। সেই নির্দেশিকা অনুসরণ করে এমন উদাহরণ দিন। আপনি তাপমাত্রা সামঞ্জস্য করার চেষ্টাও করতে পারেন। কোড তৈরি করার জন্য বা মার্কডাউন টেবিলের মতো খুব কাঠামোগত আউটপুট তৈরি করার জন্য, উচ্চ তাপমাত্রা আরও ভাল কাজ করে বলে প্রমাণিত হয়েছে (>= 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.
              
  • তাপমাত্রা সামঞ্জস্য করার চেষ্টা করুন। উচ্চ তাপমাত্রা (>= ০.৮) সাধারণত আউটপুটে পুনরাবৃত্তি বা ডুপ্লিকেশন দূর করতে সাহায্য করে।
স্ট্রাকচার্ড আউটপুটে পুনরাবৃত্তি হওয়া নতুন লাইন ( \n ) যখন মডেল ইনপুটে \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.
      
পুনরাবৃত্তিমূলক টেক্সট যা স্ট্রাকচার্ড আউটপুটের অংশ নয় মডেলটি যদি এমন কোনও অনুরোধে আটকে যায় যা সমাধান করতে পারে না, তাহলে এটি ঘটতে পারে।
  • যদি চিন্তাভাবনা চালু থাকে, তাহলে নির্দেশাবলীতে সমস্যাটি কীভাবে সমাধান করতে হবে তার স্পষ্ট নির্দেশ দেওয়া এড়িয়ে চলুন। কেবল চূড়ান্ত ফলাফলের জন্য জিজ্ঞাসা করুন।
  • ০.৮ থেকে বেশি তাপমাত্রা চেষ্টা করুন।
  • "সংক্ষিপ্ত হোন", "নিজেকে পুনরাবৃত্তি করবেন না", অথবা "একবার উত্তর দিন" এর মতো নির্দেশাবলী যোগ করুন।

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

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

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

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

জ্ঞাত সমস্যা

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

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

আপনার যদি কোন প্রশ্ন থাকে, তাহলে গুগল এআই ডেভেলপার ফোরামে আলোচনায় যোগ দিন।