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

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

• پایتون-ژنای
• js-genai
• گو-گنای

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

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

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

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

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

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

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

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

تأخیر بالاتر یا استفاده از توکن با مدل‌های ۲.۵

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

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

مسائل ایمنی

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

اگر BlockedReason.OTHER مشاهده کردید، ممکن است پرس‌وجو یا پاسخ، شرایط خدمات را نقض کند یا به هر دلیلی پشتیبانی نشود.

مسئله تلاوت

اگر مشاهده کردید که مدل به دلیل RECITATION تولید خروجی را متوقف می‌کند، این بدان معناست که خروجی مدل ممکن است شبیه داده‌های خاصی باشد. برای رفع این مشکل، سعی کنید prompt/context را تا حد امکان منحصر به فرد کنید و از دمای بالاتری استفاده کنید.

مشکل توکن‌های تکراری

اگر نشانه‌های خروجی مکرر را مشاهده کردید، پیشنهادات زیر را برای کاهش یا حذف آنها امتحان کنید.

          # 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 مسدود شده یا غیرفعال

این بخش نحوه بررسی مسدود شدن کلید API Gemini شما و اقدامات لازم در این مورد را شرح می‌دهد.

بفهمید که چرا کلیدها مسدود شده‌اند

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

تأیید کنید که آیا کلیدهای شما تحت تأثیر قرار گرفته‌اند یا خیر

اگر مشخص شود که کلید شما لو رفته است، دیگر نمی‌توانید از آن کلید با API Gemini استفاده کنید. می‌توانید از Google AI Studio استفاده کنید تا ببینید آیا هیچ یک از کلیدهای API شما از فراخوانی API Gemini مسدود شده‌اند یا خیر و کلیدهای جدیدی تولید کنید. همچنین ممکن است هنگام تلاش برای استفاده از این کلیدها، خطای زیر را مشاهده کنید:

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

اقدام برای کلیدهای API مسدود شده

شما باید با استفاده از Google AI Studio کلیدهای API جدیدی برای ادغام‌های Gemini API خود ایجاد کنید. ما اکیداً توصیه می‌کنیم شیوه‌های مدیریت کلید API خود را بررسی کنید تا مطمئن شوید که کلیدهای جدید شما ایمن نگه داشته می‌شوند و در معرض دید عموم قرار نمی‌گیرند.

هزینه‌های غیرمنتظره به دلیل آسیب‌پذیری

یک پرونده پشتیبانی صورتحساب ارسال کنید . تیم صورتحساب ما در حال کار بر روی این موضوع است و در اسرع وقت به‌روزرسانی‌ها را اطلاع‌رسانی خواهیم کرد.

اقدامات امنیتی گوگل برای کلیدهای فاش شده

در صورت فاش شدن کلیدهای API من، گوگل چگونه می‌خواهد به ایمن‌سازی حساب من در برابر افزایش هزینه و سوءاستفاده کمک کند؟

• ما در حال حرکت به سمتی هستیم که وقتی شما با استفاده از Google AI Studio درخواست کلید جدیدی می‌کنید، کلیدهای API را صادر کنیم که به طور پیش‌فرض فقط به Google AI Studio محدود می‌شود و کلیدهای سایر سرویس‌ها را نمی‌پذیرد. این امر به جلوگیری از هرگونه استفاده ناخواسته از کلیدهای متقاطع کمک می‌کند.
• ما به طور پیش‌فرض کلیدهای API که فاش شده و با API Gemini استفاده می‌شوند را مسدود می‌کنیم و به جلوگیری از سوءاستفاده از هزینه و داده‌های برنامه شما کمک می‌کنیم.
• شما می‌توانید وضعیت کلیدهای API خود را در Google AI Studio مشاهده کنید و ما به محض شناسایی فاش شدن کلیدهای API شما، فوراً با شما تماس خواهیم گرفت تا اقدامات لازم را انجام دهیم.

بهبود خروجی مدل

برای خروجی‌های مدل با کیفیت بالاتر، نوشتن دستورالعمل‌های ساختاریافته‌تر را بررسی کنید. صفحه راهنمای مهندسی دستورالعمل، برخی از مفاهیم اساسی، استراتژی‌ها و بهترین شیوه‌ها را برای شروع کار معرفی می‌کند.

محدودیت‌های توکن را درک کنید

برای درک بهتر نحوه شمارش توکن‌ها و محدودیت‌های آنها، راهنمای توکن ما را مطالعه کنید.

مشکلات شناخته شده

• این API فقط از تعدادی زبان منتخب پشتیبانی می‌کند. ارسال درخواست‌ها به زبان‌های پشتیبانی نشده می‌تواند پاسخ‌های غیرمنتظره یا حتی مسدود شده ایجاد کند. برای به‌روزرسانی‌ها به زبان‌های موجود مراجعه کنید.

ثبت اشکال

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