محدودیتهای نرخ، تعداد درخواستهایی را که میتوانید در یک بازه زمانی مشخص به API Gemini ارسال کنید، تنظیم میکنند. این محدودیتها به حفظ استفاده منصفانه، محافظت در برابر سوءاستفاده و حفظ عملکرد سیستم برای همه کاربران کمک میکنند.
محدودیتهای نرخ فعال خود را در AI Studio مشاهده کنید
نحوه عملکرد محدودیتهای نرخ
محدودیتهای نرخ معمولاً در سه بعد اندازهگیری میشوند:
- درخواست در دقیقه ( RPM )
- توکن در دقیقه (ورودی) ( TPM )
- تعداد درخواست در روز ( RPD )
میزان استفاده شما در مقایسه با هر محدودیت ارزیابی میشود و تجاوز از هر یک از آنها باعث ایجاد خطای محدودیت نرخ میشود. به عنوان مثال، اگر محدودیت RPM شما 20 باشد، ارسال 21 درخواست در عرض یک دقیقه منجر به خطا خواهد شد، حتی اگر از TPM یا سایر محدودیتهای خود تجاوز نکرده باشید.
محدودیتهای نرخ برای هر پروژه اعمال میشوند، نه برای هر کلید API. سهمیه درخواستها در هر روز ( RPD ) در نیمهشب به وقت اقیانوس آرام بازنشانی میشود.
محدودیتها بسته به مدل خاص مورد استفاده متفاوت است و برخی محدودیتها فقط برای مدلهای خاص اعمال میشوند. به عنوان مثال، تعداد تصاویر در هر دقیقه یا IPM فقط برای مدلهایی که قادر به تولید تصاویر هستند (Imagen 3) محاسبه میشود، اما از نظر مفهومی شبیه به TPM است. مدلهای دیگر ممکن است محدودیت تعداد توکن در هر روز (TPD) داشته باشند.
محدودیتهای نرخ برای مدلهای آزمایشی و پیشنمایش محدودتر است.
سطوح استفاده
محدودیتهای نرخ به سطح استفاده پروژه وابسته هستند. با افزایش استفاده و هزینههای API شما، میتوانید به سطح بالاتری با محدودیتهای نرخ بیشتر ارتقا دهید.
شرایط لازم برای سطوح ۲ و ۳ بر اساس کل هزینههای تجمعی در سرویسهای Google Cloud (از جمله، اما نه محدود به، رابط برنامهنویسی نرمافزار Gemini) برای حساب صورتحساب مرتبط با پروژه شما تعیین میشود.
| ردیف | صلاحیتها |
|---|---|
| رایگان | کاربران در کشورهای واجد شرایط |
| ردیف ۱ | حساب صورتحساب کامل پرداخت شده مرتبط با پروژه |
| ردیف ۲ | کل هزینه: > 250 دلار و حداقل 30 روز از پرداخت موفق گذشته باشد |
| ردیف ۳ | کل هزینه: > ۱۰۰۰ دلار و حداقل ۳۰ روز از پرداخت موفق گذشته باشد |
وقتی درخواست ارتقاء میدهید، سیستم خودکار محافظت در برابر سوءاستفاده ما بررسیهای بیشتری انجام میدهد. اگرچه احراز معیارهای صلاحیت ذکر شده عموماً برای تأیید کافی است، در موارد نادر ممکن است درخواست ارتقاء بر اساس عوامل دیگری که در طول فرآیند بررسی مشخص میشوند، رد شود.
این سیستم به حفظ امنیت و یکپارچگی پلتفرم Gemini API برای همه کاربران کمک میکند.
محدودیتهای نرخ API جمینی
محدودیتهای نرخ به عوامل مختلفی (مانند سطح سهمیه شما) بستگی دارد و میتوانید آنها را در Google AI Studio مشاهده کنید. با تغییر سطح و وضعیت حساب شما در طول زمان، محدودیتهای نرخ شما به طور خودکار بهروزرسانی میشوند.
محدودیتهای نرخ فعال خود را در AI Studio مشاهده کنید
محدودیتهای نرخ مشخصشده تضمینشده نیستند و ظرفیت واقعی ممکن است متفاوت باشد.
محدودیتهای نرخ API دستهای
درخواستهای API دستهای، جدا از فراخوانیهای API غیر دستهای، مشمول محدودیتهای نرخ خاص خود هستند.
- درخواستهای دستهای همزمان: ۱۰۰
- محدودیت حجم فایل ورودی: ۲ گیگابایت
- محدودیت ذخیرهسازی فایل: ۲۰ گیگابایت
- توکنهای صفبندیشده برای هر مدل: ستون توکنهای صفبندیشدهی دستهای در جدول محدودیتهای نرخ، حداکثر تعداد توکنهایی را که میتوانند برای پردازش دستهای در تمام کارهای دستهای فعال شما برای یک مدل معین صفبندی شوند، فهرست میکند. به جدول محدودیتهای نرخ استاندارد API مراجعه کنید.
ردیف ۱
| مدل | توکنهای دستهای در صف قرار داده شده | |||
|---|---|---|---|---|
| مدلهای متنمحور | ||||
| پیشنمایش جمینی ۳ پرو | ۵۰،۰۰۰،۰۰۰ | |||
| جمینی ۲.۵ پرو | ۵،۰۰۰،۰۰۰ | |||
| فلش جمینی ۲.۵ | ۳،۰۰۰،۰۰۰ | |||
| پیشنمایش فلش Gemini 2.5 | ۳،۰۰۰،۰۰۰ | |||
| جمینی ۲.۵ فلش-لایت | ۱۰،۰۰۰،۰۰۰ | |||
| پیشنمایش Gemini 2.5 Flash-Lite | ۱۰،۰۰۰،۰۰۰ | |||
| فلش جمینی ۲.۰ | ۱۰،۰۰۰،۰۰۰ | |||
| جمینی ۲.۰ فلش-لایت | ۱۰،۰۰۰،۰۰۰ | |||
| مدلهای تولید چندوجهی | ||||
| پیشنمایش تصویر Gemini 3 Pro 🍌 | ۲،۰۰۰،۰۰۰ | |||
ردیف ۲
| مدل | توکنهای دستهای در صف قرار داده شده | |||
|---|---|---|---|---|
| مدلهای متنمحور | ||||
| پیشنمایش جمینی ۳ پرو | ۵۰۰،۰۰۰،۰۰۰ | |||
| جمینی ۲.۵ پرو | ۵۰۰،۰۰۰،۰۰۰ | |||
| فلش جمینی ۲.۵ | ۴۰۰،۰۰۰،۰۰۰ | |||
| پیشنمایش فلش Gemini 2.5 | ۴۰۰،۰۰۰،۰۰۰ | |||
| جمینی ۲.۵ فلش-لایت | ۵۰۰،۰۰۰،۰۰۰ | |||
| پیشنمایش Gemini 2.5 Flash-Lite | ۵۰۰،۰۰۰،۰۰۰ | |||
| فلش جمینی ۲.۰ | ۱,۰۰۰,۰۰۰,۰۰۰ | |||
| جمینی ۲.۰ فلش-لایت | ۱,۰۰۰,۰۰۰,۰۰۰ | |||
| مدلهای تولید چندوجهی | ||||
| پیشنمایش تصویر Gemini 3 Pro 🍌 | ۲۷۰،۰۰۰،۰۰۰ | |||
ردیف ۳
| توکنهای دستهای در صف قرار داده شده | ||||
|---|---|---|---|---|
| مدلهای متنمحور | ||||
| پیشنمایش جمینی ۳ پرو | ۱,۰۰۰,۰۰۰,۰۰۰ | |||
| جمینی ۲.۵ پرو | ۱,۰۰۰,۰۰۰,۰۰۰ | |||
| فلش جمینی ۲.۵ | ۱,۰۰۰,۰۰۰,۰۰۰ | |||
| پیشنمایش فلش Gemini 2.5 | ۱,۰۰۰,۰۰۰,۰۰۰ | |||
| جمینی ۲.۵ فلش-لایت | ۱,۰۰۰,۰۰۰,۰۰۰ | |||
| پیشنمایش Gemini 2.5 Flash-Lite | ۱,۰۰۰,۰۰۰,۰۰۰ | |||
| فلش جمینی ۲.۰ | ۵،۰۰۰،۰۰۰،۰۰۰ | |||
| جمینی ۲.۰ فلش-لایت | ۵،۰۰۰،۰۰۰،۰۰۰ | |||
| مدلهای تولید چندوجهی | ||||
| پیشنمایش تصویر Gemini 3 Pro 🍌 | ۵۰۰۰ | ۵،۰۰۰،۰۰۰ | * | ۱,۰۰۰,۰۰۰,۰۰۰ |
نحوه ارتقا به سطح بالاتر
رابط برنامهنویسی نرمافزار Gemini از Cloud Billing برای تمام سرویسهای پرداخت استفاده میکند. برای انتقال از سطح رایگان به سطح پولی، ابتدا باید Cloud Billing را برای پروژه Google Cloud خود فعال کنید.
زمانی که پروژه شما معیارهای مشخص شده را برآورده کند، واجد شرایط ارتقاء به سطح بالاتر میشود. برای درخواست ارتقاء، این مراحل را دنبال کنید:
- به صفحه کلیدهای API در AI Studio بروید.
- پروژهای را که میخواهید ارتقا دهید پیدا کنید و روی «ارتقا» کلیک کنید. گزینه «ارتقا» فقط برای پروژههایی نمایش داده میشود که شرایط سطح بعدی را برآورده میکنند.
پس از اعتبارسنجی سریع، پروژه به سطح بعدی ارتقا مییابد.
درخواست افزایش سقف نرخ
هر مدل دارای محدودیت سرعت مرتبط (تعداد درخواست در دقیقه، RPM) است. برای جزئیات بیشتر در مورد این محدودیتهای سرعت، به مدلهای Gemini مراجعه کنید.
درخواست افزایش سقف نرخ ردیف پولی
ما هیچ تضمینی در مورد افزایش سقف نرخ شما ارائه نمیدهیم، اما تمام تلاش خود را برای بررسی درخواست شما خواهیم کرد.