از این راهنما برای کمک به تشخیص و حل مشکلات رایجی که هنگام تماس با Gemini API ایجاد میشوند، استفاده کنید. اگر با مشکلات کلید API مواجه شدید، مطمئن شوید که کلید API خود را به درستی طبق راهنمای تنظیم کلید API تنظیم کرده اید.
کدهای خطا
جدول زیر کدهای خطای رایجی را که ممکن است با آنها مواجه شوید، همراه با توضیحاتی درباره دلایل و مراحل عیبیابی فهرست میکند:
کد HTTP | وضعیت | شرح | راه حل |
400 | INVALID_ARGUMENT | بدنه درخواست بد شکل است. | مرجع API را برای قالب درخواست، نمونه ها و نسخه های پشتیبانی شده بررسی کنید. استفاده از ویژگیهای نسخه API جدیدتر با نقطه پایانی قدیمیتر میتواند باعث ایجاد خطا شود. |
400 | FAILED_PRECONDITION | سطح رایگان Gemini API در کشور شما در دسترس نیست. لطفاً صورتحساب پروژه خود را در Google AI Studio فعال کنید. | برای استفاده از Gemini API، باید با استفاده از Google AI Studio یک طرح پولی تنظیم کنید. |
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 در دسترس خواهد بود.
بررسی کنید که آیا مدل مناسبی دارید
مطمئن شوید که از مدل پشتیبانی شده ای استفاده می کنید که در صفحه مدل های ما ذکر شده است.
مسائل ایمنی
اگر میبینید که درخواستی به دلیل تنظیم ایمنی در تماس API مسدود شده است، درخواست را با توجه به فیلترهایی که در تماس API تنظیم کردهاید بررسی کنید.
اگر BlockedReason.OTHER
را مشاهده کردید، ممکن است پرس و جو یا پاسخ، شرایط خدمات را نقض کند یا به نحو دیگری پشتیبانی نشود.
بهبود خروجی مدل
برای خروجی های مدل با کیفیت بالاتر، نوشتن دستورات ساختاریافته تر را بررسی کنید. مقدمه صفحه طراحی سریع برخی از مفاهیم اساسی، استراتژی ها و بهترین روش ها را برای شروع به کار معرفی می کند.
اگر صدها نمونه از جفت های ورودی/خروجی خوب دارید، می توانید تنظیم مدل را نیز در نظر بگیرید.
محدودیت های نشانه را درک کنید
برای درک بهتر نحوه شمارش توکنها و محدودیتهای آنها ، راهنمای توکن ما را بخوانید.
مشکلات شناخته شده
- API فقط انگلیسی را پشتیبانی می کند. ارسال درخواستها به زبانهای مختلف میتواند پاسخهای غیرمنتظره یا حتی مسدود شده ایجاد کند. برای بهروزرسانی، زبانهای موجود را ببینید.
یک اشکال را ثبت کنید
اگر سوالی دارید به بحث در انجمن توسعه دهندگان هوش مصنوعی گوگل بپیوندید.