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

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

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

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

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

کد HTTP وضعیت توضیحات مثال راه حل
400 INVALID_ARGUMENT بدنه درخواست بد شکل است. یک اشتباه تایپی یا یک قسمت الزامی در درخواست شما وجود ندارد. مرجع API را برای قالب درخواست، نمونه ها و نسخه های پشتیبانی شده بررسی کنید. استفاده از ویژگی‌های نسخه API جدیدتر با نقطه پایانی قدیمی‌تر می‌تواند باعث ایجاد خطا شود.
400 FAILED_PRECONDITION سطح رایگان Gemini API در کشور شما در دسترس نیست. لطفاً صورتحساب پروژه خود را در Google AI Studio فعال کنید. شما در منطقه‌ای درخواست می‌کنید که در آن لایه رایگان پشتیبانی نمی‌شود و صورت‌حساب پروژه خود را در Google AI Studio فعال نکرده‌اید. برای استفاده از Gemini API، باید با استفاده از Google AI Studio یک طرح پولی تنظیم کنید.
403 PERMISSION_DENIED کلید API شما مجوزهای لازم را ندارد. شما از کلید API اشتباه استفاده می کنید. شما در حال تلاش برای استفاده از یک مدل تنظیم شده بدون انجام احراز هویت مناسب هستید. بررسی کنید که کلید API تنظیم شده باشد و دسترسی مناسبی داشته باشد. و مطمئن شوید که برای استفاده از مدل های تنظیم شده، احراز هویت مناسب را انجام داده اید.
404 NOT_FOUND منبع درخواستی پیدا نشد. تصویر، فایل صوتی یا ویدیویی که در درخواست شما ارجاع داده شده بود، یافت نشد. بررسی کنید که آیا تمام پارامترهای درخواست شما برای نسخه API شما معتبر هستند یا خیر.
429 RESOURCE_EXHAUSTED شما از حد مجاز تجاوز کرده اید. شما در هر دقیقه درخواست های زیادی را با API لایه رایگان Gemini ارسال می کنید. مطمئن شوید که در محدوده نرخ مدل هستید. در صورت نیاز درخواست افزایش سهمیه کنید .
500 داخلی یک خطای غیرمنتظره در سمت Google رخ داد. زمینه ورودی شما خیلی طولانی است. زمینه ورودی خود را کاهش دهید یا به طور موقت به مدل دیگری بروید (مثلاً از Gemini 1.5 Pro به Gemini 1.5 Flash) و ببینید که آیا کار می کند یا خیر. یا کمی صبر کنید و درخواست خود را دوباره امتحان کنید. اگر بعد از امتحان مجدد مشکل همچنان ادامه داشت، لطفاً با استفاده از دکمه ارسال بازخورد در Google AI Studio آن را گزارش دهید.
503 در دسترس نیست ممکن است سرویس به طور موقت بیش از حد بارگیری شده یا از کار بیفتد. ظرفیت سرویس به طور موقت در حال اتمام است. به طور موقت به مدل دیگری بروید (مثلاً از Gemini 1.5 Pro به Gemini 1.5 Flash) و ببینید که آیا کار می کند یا خیر. یا کمی صبر کنید و درخواست خود را دوباره امتحان کنید. اگر بعد از امتحان مجدد مشکل همچنان ادامه داشت، لطفاً با استفاده از دکمه ارسال بازخورد در Google AI Studio آن را گزارش دهید.
504 DEADLINE_EXCEEDED این سرویس نمی تواند پردازش را در مهلت مقرر به پایان برساند. درخواست (یا زمینه) شما برای پردازش به موقع بسیار بزرگ است. برای جلوگیری از این خطا، یک "تایم اوت" بزرگتر در درخواست مشتری خود تنظیم کنید.

کدهای خطای Client SDK

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

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

پارامتر مدل مقادیر (محدوده)
تعداد نامزدها 1-8 (عدد صحیح)
دما 0.0-1.0
حداکثر توکن های خروجی از get_model ( Python ) برای تعیین حداکثر تعداد توکن برای مدلی که استفاده می کنید استفاده کنید.
TopP 0.0-1.0

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

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

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

مسائل ایمنی

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

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

مسئله تلاوت

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

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

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

اگر صدها نمونه از جفت های ورودی/خروجی خوب دارید، می توانید تنظیم مدل را نیز در نظر بگیرید.

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

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

مسائل شناخته شده

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

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

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