از این راهنما برای کمک به تشخیص و حل مشکلات رایجی که هنگام تماس با Gemini API ایجاد می‌شوند، استفاده کنید. اگر با مشکلات کلید API مواجه شدید، مطمئن شوید که کلید API خود را به درستی طبق راهنمای تنظیم کلید API تنظیم کرده اید.
کدهای خطا
جدول زیر کدهای خطای رایجی را که ممکن است با آن‌ها مواجه شوید، همراه با توضیحاتی درباره دلایل و مراحل عیب‌یابی فهرست می‌کند:
| کد HTTP | وضعیت | شرح | راه حل |
| 400 | INVALID_ARGUMENT | بدنه درخواست بد شکل است. | مرجع API را برای قالب درخواست، نمونه ها و نسخه های پشتیبانی شده بررسی کنید. استفاده از ویژگی‌های نسخه API جدیدتر با نقطه پایانی قدیمی‌تر می‌تواند باعث ایجاد خطا شود. |
| 403 | PERMISSION_DENIED | کلید API شما مجوزهای لازم را ندارد. | بررسی کنید که کلید API تنظیم شده باشد و دسترسی مناسبی داشته باشد. |
| 404 | پیدا نشد | منبع درخواستی پیدا نشد. | بررسی کنید که آیا تمام پارامترهای درخواست شما برای نسخه API شما معتبر هستند یا خیر. |
| 429 | RESOURCE_EXHAUSTED | شما از حد مجاز تجاوز کرده اید. | مطمئن شوید که در محدوده نرخ مدل هستید. در صورت نیاز درخواست افزایش سهمیه کنید . |
| 500 | درونی؛ داخلی | یک خطای غیرمنتظره در سمت Google رخ داد. | کمی صبر کنید و درخواست خود را دوباره امتحان کنید. اگر بعد از امتحان مجدد مشکل همچنان ادامه داشت، لطفاً با استفاده از دکمه ارسال بازخورد در Google AI Studio آن را گزارش دهید. |
| 503 | غیر قابل دسترسی | ممکن است سرویس به طور موقت بیش از حد بارگیری شده یا از کار بیفتد. | کمی صبر کنید و درخواست خود را دوباره امتحان کنید. اگر بعد از امتحان مجدد مشکل همچنان ادامه داشت، لطفاً با استفاده از دکمه ارسال بازخورد در Google AI Studio آن را گزارش دهید. |
تماس های API خود را برای خطاهای پارامتر مدل بررسی کنید
مطمئن شوید که پارامترهای مدل شما در مقادیر زیر هستند:
| پارامتر مدل | مقادیر (محدوده) |
| تعداد نامزدها | 1-8 (عدد صحیح) |
| درجه حرارت | 0.0-1.0 |
| حداکثر توکن های خروجی | از get_model ( Python ) برای تعیین حداکثر تعداد توکن برای مدلی که استفاده می کنید استفاده کنید. |
| TopP | 0.0-1.0 |
علاوه بر بررسی مقادیر پارامتر، مطمئن شوید که از نسخه API صحیح (مثلاً /v1 یا /v1beta ) و مدلی استفاده می‌کنید که از ویژگی‌های مورد نیاز شما پشتیبانی می‌کند. به عنوان مثال، اگر یک ویژگی در نسخه بتا باشد، فقط در نسخه /v1beta API در دسترس خواهد بود.
بررسی کنید که آیا مدل مناسبی دارید
مطمئن شوید که از یک مدل پشتیبانی شده استفاده می کنید. از list_models ( Python ) برای در دسترس قرار دادن همه مدل ها برای استفاده استفاده کنید.
مسائل ایمنی
اگر می‌بینید که درخواستی به دلیل تنظیم ایمنی در تماس API مسدود شده است، درخواست را با توجه به فیلترهایی که در تماس API تنظیم کرده‌اید بررسی کنید.
اگر BlockedReason.OTHER را مشاهده کردید، ممکن است پرس و جو یا پاسخ ، شرایط خدمات را نقض کند یا به نحو دیگری پشتیبانی نشود.
بهبود خروجی مدل
برای خروجی های مدل با کیفیت بالاتر، نوشتن دستورات ساختاریافته تر را بررسی کنید. مقدمه صفحه طراحی سریع برخی از مفاهیم اساسی، استراتژی ها و بهترین روش ها را برای شروع به کار معرفی می کند.
اگر صدها نمونه از جفت های ورودی/خروجی خوب دارید، می توانید تنظیم مدل را نیز در نظر بگیرید.
محدودیت های نشانه را درک کنید
از ModelService API برای دریافت فراداده های اضافی در مورد مدل ها، از جمله محدودیت های رمز ورودی و خروجی استفاده کنید.
برای دریافت نشانه های مورد استفاده توسط درخواست شما، از countMessageTokens برای مدل های چت و countTextTokens برای مدل های متنی استفاده کنید.
مشکلات شناخته شده
- پشتیبانی موبایل از Google AI Studio: در حالی که می‌توانید وب‌سایت را در تلفن همراه باز کنید، برای نمایشگرهای کوچک بهینه نشده است.
- API فقط انگلیسی را پشتیبانی می کند. ارسال درخواست‌ها به زبان‌های مختلف می‌تواند پاسخ‌های غیرمنتظره یا حتی مسدود شده ایجاد کند. برای به‌روزرسانی، زبان‌های موجود را ببینید.
یک اشکال را ثبت کنید
برای پرسیدن سؤال یا ارسال درخواست های ویژگی یا اشکال، مشکلی را در Github ثبت کنید.