محدودیتهای نرخ، تعداد درخواستهایی را که میتوانید در یک بازه زمانی مشخص به API Gemini ارسال کنید، تنظیم میکنند. این محدودیتها به حفظ استفاده منصفانه، محافظت در برابر سوءاستفاده و حفظ عملکرد سیستم برای همه کاربران کمک میکنند.
محدودیتهای نرخ فعال خود را در AI Studio مشاهده کنید
نحوه عملکرد محدودیتهای نرخ
محدودیتهای نرخ معمولاً در سه بعد اندازهگیری میشوند:
- درخواست در دقیقه ( RPM )
- توکن در دقیقه (ورودی) ( TPM )
- تعداد درخواست در روز ( RPD )
میزان استفاده شما در مقایسه با هر محدودیت ارزیابی میشود و تجاوز از هر یک از آنها باعث ایجاد خطای محدودیت نرخ میشود. به عنوان مثال، اگر محدودیت RPM شما 20 باشد، ارسال 21 درخواست در عرض یک دقیقه منجر به خطا خواهد شد، حتی اگر از TPM یا سایر محدودیتهای خود تجاوز نکرده باشید.
محدودیتهای نرخ برای هر پروژه اعمال میشوند، نه برای هر کلید API. سهمیه درخواستها در هر روز ( RPD ) در نیمهشب به وقت اقیانوس آرام بازنشانی میشود.
محدودیتها بسته به مدل خاص مورد استفاده متفاوت است و برخی محدودیتها فقط برای مدلهای خاص اعمال میشوند. به عنوان مثال، تعداد تصاویر در دقیقه یا IPM فقط برای مدلهایی که قادر به تولید تصاویر هستند (نانو موز) محاسبه میشود، اما از نظر مفهومی شبیه به TPM است. مدلهای دیگر ممکن است محدودیت توکن در روز (TPD) داشته باشند.
محدودیتهای نرخ برای مدلهای آزمایشی و پیشنمایش محدودتر است.
محدودیتهای نرخ مبتنی بر هزینه
علاوه بر محدودیتهای درخواست در دقیقه (RPM) و توکن در دقیقه (TPM)، رابط برنامهنویسی نرمافزار Gemini محدودیتهای نرخ مبتنی بر هزینه را برای محافظت در برابر هزینههای غیرمنتظره اعمال میکند. اینکه آیا این محدودیتها برای حساب شما اعمال میشوند یا خیر، به سابقه صورتحساب و سطح استفاده شما بستگی دارد.
جدول زیر محدودیتهای نرخ مبتنی بر هزینه را برای هر سطح استفاده نشان میدهد. این محدودیتها در یک بازه زمانی ۱۰ دقیقهای ارزیابی میشوند. اینکه آیا این محدودیتها برای حساب شما اعمال میشوند یا خیر، به سابقه صورتحساب و وضعیت حساب شما بستگی دارد.
| ردیف استفاده | محدودیت نرخ خرج (به ازای هر 10 دقیقه) |
|---|---|
| رایگان | ناموجود |
| ردیف ۱ | ۱۰ دلار |
| ردیف ۲ | ۵۰ دلار |
| ردیف ۳ | ۲۰۰ دلار |
اگر به محدودیت نرخ مبتنی بر هزینه برسید، API خطای 429 RESOURCE_EXHAUSTED را برمیگرداند. برای حل این مشکل:
- صبر کنید و پس از مدت کوتاهی دوباره امتحان کنید .
- نرخ درخواستهای پرهزینه را کاهش دهید ، برای مثال با استفاده از پنجرههای متنی کوچکتر یا خروجیهای کوتاهتر.
- اگر در طول استفاده عادی مرتباً به این حد مجاز میرسید، درخواست افزایش حد مجاز را بدهید .
سطوح استفاده
محدودیتهای نرخ به سطح استفاده پروژه وابسته هستند. با افزایش استفاده و هزینههای API شما، به طور خودکار به سطح بالاتری با محدودیتهای نرخ افزایشیافته ارتقا خواهید یافت.
شرایط لازم برای سطوح ۲ و ۳ بر اساس کل هزینههای تجمعی در سرویسهای Google Cloud (از جمله، اما نه محدود به، رابط برنامهنویسی نرمافزار Gemini) برای حساب صورتحساب مرتبط با پروژه شما تعیین میشود.
| ردیف استفاده | صلاحیت | سقف ردیف صورتحساب |
|---|---|---|
| رایگان | پروژه فعال یا دوره آزمایشی رایگان | ناموجود |
| ردیف ۱ | یک حساب صورتحساب فعال راهاندازی و پیوند دهید | ۲۵۰ دلار |
| ردیف ۲ | پرداخت ۱۰۰ دلار + ۳ روز پس از اولین پرداخت موفق | ۲۰۰۰ دلار |
| ردیف ۳ | پرداخت ۱۰۰۰ دلار + ۳۰ روز از اولین پرداخت موفق | ۲۰،۰۰۰ تا ۱۰۰،۰۰۰ دلار + |
اگرچه احراز معیارهای صلاحیت ذکر شده عموماً برای تأیید کافی است، در موارد نادر، درخواست ارتقا ممکن است بر اساس سایر عواملی که در طول فرآیند بررسی مشخص شدهاند، رد شود.
این سیستم به حفظ امنیت و یکپارچگی پلتفرم Gemini API برای همه کاربران کمک میکند.
محدودیتهای نرخ API جمینی
محدودیتهای نرخ به عوامل مختلفی (مانند سطح استفاده شما) بستگی دارد و میتوان آنها را در Google AI Studio مشاهده کرد. با تغییر سطح و وضعیت حساب شما در طول زمان، محدودیتهای نرخ شما بهطور خودکار بهروزرسانی میشوند.
محدودیتهای نرخ فعال خود را در AI Studio مشاهده کنید
محدودیتهای نرخ مشخصشده تضمینشده نیستند و ظرفیت واقعی ممکن است متفاوت باشد.
محدودیتهای نرخ استنتاج اولویت
مصرف اولویتدار، محدودیتهای نرخ خاص خود را دارد، حتی اگر مصرف در محدودیتهای نرخ ترافیک تعاملی کلی محاسبه شود. محدودیتهای نرخ پیشفرض عبارتند از: 0.3 برابر حد استاندارد نرخ برای هر مدل و سطح
محدودیتهای نرخ API دستهای
درخواستهای API دستهای، جدا از فراخوانیهای API غیر دستهای، مشمول محدودیتهای نرخ خاص خود هستند.
- درخواستهای دستهای همزمان: ۱۰۰
- محدودیت حجم فایل ورودی: ۲ گیگابایت
- محدودیت ذخیرهسازی فایل: ۲۰ گیگابایت
- توکنهای صفبندیشده به ازای هر مدل: جدول توکنهای صفبندیشدهی دستهای ، حداکثر تعداد توکنهایی را که میتوانند برای پردازش دستهای در تمام کارهای دستهای فعال شما برای یک مدل معین صفبندی شوند، فهرست میکند.
ردیف ۱
| مدل | توکنهای دستهای در صف قرار داده شده | |||
|---|---|---|---|---|
| مدلهای متنمحور | ||||
| پیشنمایش Gemini 3.1 Pro | ۵،۰۰۰،۰۰۰ | |||
| جمینی ۳.۵ فلش-لایت | ۱۰،۰۰۰،۰۰۰ | |||
| فلش جمینی ۳.۷ | ۳،۰۰۰،۰۰۰ | |||
| جمینی ۳.۱ فلش لایت | ۱۰،۰۰۰،۰۰۰ | |||
| پیشنمایش Gemini 3.1 Flash Lite | ۱۰،۰۰۰،۰۰۰ | |||
| فلش جمینی ۳.۶ | ۳،۰۰۰،۰۰۰ | |||
| فلش جمینی ۳.۵ | ۳،۰۰۰،۰۰۰ | |||
| جمینی ۲.۵ پرو | ۵،۰۰۰،۰۰۰ | |||
| جمینی ۲.۵ پرو TTS | ۲۵۰۰۰ | |||
| فلش جمینی ۲.۵ | ۳،۰۰۰،۰۰۰ | |||
| پیشنمایش فلش Gemini 2.5 | ۳،۰۰۰،۰۰۰ | |||
| پیشنمایش تصویر فلش Gemini 2.5 | ۳،۰۰۰،۰۰۰ | |||
| جمینی ۲.۵ فلش TTS | ۱۰۰۰۰۰ | |||
| جمینی ۲.۵ فلش لایت | ۱۰،۰۰۰،۰۰۰ | |||
| پیشنمایش Gemini 2.5 Flash Lite | ۱۰،۰۰۰،۰۰۰ | |||
| فلش جمینی ۲.۰ | ۱۰،۰۰۰،۰۰۰ | |||