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

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

• পাইথন-জেনাই
• js-genai
• গো-জেনাই

যদি আপনি এপিআই কী (API key) সংক্রান্ত সমস্যার সম্মুখীন হন, তবে এপিআই কী সেটআপ গাইড (API key setup guide) অনুযায়ী আপনার এপিআই কী সঠিকভাবে সেটআপ করেছেন কিনা তা যাচাই করুন।

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

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

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

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

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

আপনার কাছে সঠিক মডেল আছে কিনা তা যাচাই করুন।

নিশ্চিত করুন যে আপনি আমাদের মডেল পেজে তালিকাভুক্ত একটি সমর্থিত মডেল ব্যবহার করছেন।

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

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

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

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

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

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

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

যদি দেখেন মডেলটি ‘RECITATION’ কারণে আউটপুট দেওয়া বন্ধ করে দিয়েছে, এর মানে হলো মডেলের আউটপুটটি নির্দিষ্ট কোনো ডেটার সাথে সাদৃশ্যপূর্ণ হতে পারে। এটি ঠিক করার জন্য, প্রম্পট / কনটেক্সট যতটা সম্ভব অনন্য করার চেষ্টা করুন এবং একটি উচ্চতর তাপমাত্রা ব্যবহার করুন।

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

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

          # 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.
        

        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 key) সর্বজনীনভাবে ফাঁস হয়ে থাকতে পারে। আপনার ডেটা সুরক্ষিত রাখতে এবং অননুমোদিত প্রবেশ রোধ করতে, আমরা সক্রিয়ভাবে এই পরিচিত ফাঁস হওয়া কীগুলোকে জেমিনি এপিআই (Gemini API)-তে প্রবেশ করা থেকে ব্লক করে দিয়েছি।

আপনার কীগুলো প্রভাবিত হয়েছে কিনা তা নিশ্চিত করুন।

আপনার কী (key) ফাঁস হয়ে গেছে বলে জানা গেলে, আপনি আর জেমিনি এপিআই (Gemini API)-এর সাথে সেই কী ব্যবহার করতে পারবেন না। আপনার কোনো এপিআই কী জেমিনি এপিআই কল করার ক্ষেত্রে ব্লক করা আছে কিনা তা দেখতে এবং নতুন কী তৈরি করতে আপনি গুগল এআই স্টুডিও (Google AI Studio) ব্যবহার করতে পারেন। এই কীগুলো ব্যবহার করার চেষ্টা করার সময় আপনি নিম্নলিখিত ত্রুটিটিও দেখতে পারেন:

Your API key was reported as leaked. Please use another API key.

ব্লক করা এপিআই কীগুলির জন্য পদক্ষেপ

আপনার Gemini API ইন্টিগ্রেশনগুলির জন্য Google AI Studio ব্যবহার করে নতুন API কী তৈরি করা উচিত। আমরা দৃঢ়ভাবে সুপারিশ করছি যে আপনি আপনার API কী ব্যবস্থাপনার পদ্ধতি পর্যালোচনা করুন, যাতে আপনার নতুন কীগুলি সুরক্ষিত থাকে এবং সর্বজনীনভাবে প্রকাশ না হয়।

দুর্বলতার কারণে অপ্রত্যাশিত চার্জ

বিলিং সহায়তার জন্য একটি অভিযোগ জমা দিন । আমাদের বিলিং টিম বিষয়টি নিয়ে কাজ করছে এবং আমরা যত তাড়াতাড়ি সম্ভব নতুন তথ্য জানিয়ে দেব।

ফাঁস হওয়া কী-এর জন্য গুগলের নিরাপত্তা ব্যবস্থা

আমার এপিআই কী ফাঁস হয়ে গেলে, গুগল কীভাবে আমার অ্যাকাউন্টকে অতিরিক্ত খরচ এবং অপব্যবহার থেকে সুরক্ষিত রাখতে সাহায্য করবে?

• আমরা এমন একটি ব্যবস্থার দিকে এগোচ্ছি যেখানে গুগল এআই স্টুডিও ব্যবহার করে নতুন কী-এর জন্য অনুরোধ করলে, সেই কী ডিফল্টরূপে শুধুমাত্র গুগল এআই স্টুডিও-এর জন্যই সীমাবদ্ধ থাকবে এবং অন্য কোনো পরিষেবার কী গ্রহণ করবে না। এটি যেকোনো অনাকাঙ্ক্ষিত ক্রস-কী ব্যবহার প্রতিরোধ করতে সাহায্য করবে।
• আমরা এখন থেকে জেমিনি এপিআই-এর সাথে ব্যবহৃত এবং ফাঁস হওয়া এপিআই কী-গুলো ডিফল্টরূপে ব্লক করে দিচ্ছি, যা খরচ এবং আপনার অ্যাপ্লিকেশন ডেটার অপব্যবহার রোধ করতে সাহায্য করবে।
• আপনি গুগল এআই স্টুডিও-এর মধ্যে আপনার এপিআই কী-গুলির অবস্থা জানতে পারবেন এবং আপনার এপিআই কী-গুলি ফাঁস হয়েছে বলে শনাক্ত হলে, তাৎক্ষণিক ব্যবস্থা গ্রহণের জন্য আমরা সক্রিয়ভাবে আপনাকে জানানোর ব্যবস্থা করব।

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

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

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

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

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

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

একটি ত্রুটি রিপোর্ট করুন

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