راهنمای عیب یابی

از این راهنما برای کمک به تشخیص و حل مشکلات رایجی که هنگام تماس با Gemini API ایجاد می‌شوند، استفاده کنید. ممکن است با مشکلاتی از سرویس پشتیبان Gemini API یا SDK های مشتری مواجه شوید. SDK های مشتری ما در مخازن زیر منبع باز هستند:

• python-genai
• js-genai
• برو جنایی

اگر با مشکلات کلید API مواجه شدید، بررسی کنید که کلید API خود را به درستی طبق راهنمای تنظیم کلید API تنظیم کرده اید.

کدهای خطای سرویس Backend API Gemini

جدول زیر کدهای خطای متداولی را که ممکن است با آن‌ها مواجه شوید، همراه با توضیحاتی درباره علل و مراحل عیب‌یابی فهرست می‌کند:

تماس های API خود را برای خطاهای پارامتر مدل بررسی کنید

بررسی کنید که پارامترهای مدل شما در مقادیر زیر باشد:

علاوه بر بررسی مقادیر پارامتر، مطمئن شوید که از نسخه API صحیح (مثلاً /v1 یا /v1beta ) و مدلی استفاده می‌کنید که از ویژگی‌های مورد نیاز شما پشتیبانی می‌کند. به عنوان مثال، اگر یک ویژگی در نسخه بتا باشد، فقط در نسخه /v1beta API در دسترس خواهد بود.

بررسی کنید که آیا مدل مناسبی دارید

بررسی کنید که از یک مدل پشتیبانی شده استفاده می‌کنید که در صفحه مدل‌های ما فهرست شده است.

تأخیر بیشتر یا استفاده توکن با مدل های 2.5

اگر در مدل‌های 2.5 Flash و Pro شاهد تأخیر بیشتر یا استفاده از نشانه‌ها هستید، این می‌تواند به این دلیل باشد که فکر کردن به‌طور پیش‌فرض برای افزایش کیفیت فعال است . اگر سرعت را در اولویت قرار می دهید یا نیاز به به حداقل رساندن هزینه ها دارید، می توانید تفکر را تنظیم یا غیرفعال کنید.

برای راهنمایی و نمونه کد به صفحه تفکر مراجعه کنید.

مسائل ایمنی

اگر می‌بینید که درخواستی به دلیل تنظیم ایمنی در تماس API مسدود شده است، درخواست را با توجه به فیلترهایی که در تماس 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 فقط از تعدادی زبان منتخب پشتیبانی می کند. ارسال درخواست‌ها به زبان‌های پشتیبانی‌نشده می‌تواند پاسخ‌های غیرمنتظره یا حتی مسدود شده ایجاد کند. برای به‌روزرسانی ، زبان‌های موجود را ببینید.

یک اشکال را ثبت کنید

اگر سوالی دارید به بحث در انجمن توسعه دهندگان هوش مصنوعی گوگل بپیوندید.