محدودیت‌های نرخ، تعداد درخواست‌هایی را که می‌توانید در یک بازه زمانی مشخص به 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
جدول زیر محدودیت‌های نرخ برای همه فراخوانی‌های استاندارد API جمینی را فهرست می‌کند.
ردیف رایگان
| مدل | دور در دقیقه | تی پی ام | آر پی دی |
|---|---|---|---|
| مدل‌های متن‌محور | |||
| جمینی ۲.۵ پرو | ۵ | ۱۲۵۰۰۰ | ۱۰۰ |
| فلش جمینی ۲.۵ | ۱۰ | ۲۵۰،۰۰۰ | ۲۵۰ |
| پیش‌نمایش فلش Gemini 2.5 | ۱۰ | ۲۵۰،۰۰۰ | ۲۵۰ |
| جمینی ۲.۵ فلش-لایت | ۱۵ | ۲۵۰،۰۰۰ | ۱۰۰۰ |
| پیش‌نمایش Gemini 2.5 Flash-Lite | ۱۵ | ۲۵۰،۰۰۰ | ۱۰۰۰ |
| فلش جمینی ۲.۰ | ۱۵ | ۱,۰۰۰,۰۰۰ | ۲۰۰ |
| جمینی ۲.۰ فلش-لایت | ۳۰ | ۱,۰۰۰,۰۰۰ | ۲۰۰ |
| API زنده | |||
| جمینی ۲.۵ فلش لایو | ۳ جلسه | ۱,۰۰۰,۰۰۰ | * |
| پیش‌نمایش فلش Gemini 2.5 با صدای بومی | ۱ جلسه | ۲۵۰۰۰ | ۵ |
| جمینی ۲.۰ فلش لایو | ۳ جلسه | ۱,۰۰۰,۰۰۰ | * |
| مدل‌های تولید چندوجهی | |||
| پیش‌نمایش فلش Gemini 2.5 TTS | ۳ | ۱۰۰۰۰ | ۱۵ |
| تولید تصویر پیش‌نمایش فلش Gemini 2.0 | ۱۰ | ۲۰۰۰۰۰ | ۱۰۰ |
| مدل‌های دیگر | |||
| جما ۳ و ۳n | ۳۰ | ۱۵۰۰۰ | ۱۴,۴۰۰ |
| جاسازی جمینی | ۱۰۰ | ۳۰۰۰۰ | ۱۰۰۰ |
| پیش‌نمایش Gemini Robotics-ER 1.5 | ۱۰ | ۲۵۰،۰۰۰ | ۲۵۰ |
| مدل‌های منسوخ‌شده | |||
| فلش جمینی ۱.۵ (منسوخ شده) | ۱۵ | ۲۵۰،۰۰۰ | ۵۰ |
| جمینی ۱.۵ فلش-۸بی (منسوخ شده) | ۱۵ | ۲۵۰،۰۰۰ | ۵۰ |
ردیف ۱
| مدل | دور در دقیقه | تی پی ام | آر پی دی | توکن‌های دسته‌ای در صف قرار داده شده |
|---|---|---|---|---|
| مدل‌های متن‌محور | ||||
| جمینی ۲.۵ پرو | ۱۵۰ | ۲،۰۰۰،۰۰۰ | ۱۰۰۰۰ | ۵،۰۰۰،۰۰۰ |
| فلش جمینی ۲.۵ | ۱۰۰۰ | ۱,۰۰۰,۰۰۰ | ۱۰۰۰۰ | ۳،۰۰۰،۰۰۰ |
| پیش‌نمایش فلش Gemini 2.5 | ۱۰۰۰ | ۱,۰۰۰,۰۰۰ | ۱۰۰۰۰ | ۳،۰۰۰،۰۰۰ |
| جمینی ۲.۵ فلش-لایت | ۴۰۰۰ | ۴،۰۰۰،۰۰۰ | * | ۱۰،۰۰۰،۰۰۰ |
| پیش‌نمایش Gemini 2.5 Flash-Lite | ۴۰۰۰ | ۴،۰۰۰،۰۰۰ | * | ۱۰،۰۰۰،۰۰۰ |
| فلش جمینی ۲.۰ | ۲۰۰۰ | ۴،۰۰۰،۰۰۰ | * | ۱۰،۰۰۰،۰۰۰ |
| جمینی ۲.۰ فلش-لایت | ۴۰۰۰ | ۴،۰۰۰،۰۰۰ | * | ۱۰،۰۰۰،۰۰۰ |
| API زنده | ||||
| جمینی ۲.۵ فلش لایو | ۵۰ جلسه | ۴،۰۰۰،۰۰۰ | * | * |
| پیش‌نمایش فلش Gemini 2.5 با صدای بومی | ۳ جلسه | ۵۰،۰۰۰ | ۵۰ | * |
| جمینی ۲.۰ فلش لایو | ۵۰ جلسه | ۴،۰۰۰،۰۰۰ | * | * |
| مدل‌های تولید چندوجهی | ||||
| پیش‌نمایش فلش Gemini 2.5 TTS | ۱۰ | ۱۰۰۰۰ | ۱۰۰ | * |
| پیش‌نمایش Gemini 2.5 Pro TTS | ۱۰ | ۱۰۰۰۰ | ۵۰ | * |
| تصویر فلش Gemini 2.5 | ۵۰۰ | ۵۰۰۰۰۰ | ۲۰۰۰ | * |
| تولید تصویر پیش‌نمایش فلش Gemini 2.0 | ۱۰۰۰ | ۱,۰۰۰,۰۰۰ | ۱۰۰۰۰ | * |
| ایمیج ۴ استاندارد/سریع | ۱۰ | * | ۷۰ | * |
| ایمیجن ۴ اولترا | ۵ | * | ۳۰ | * |
| تصویر ۳ | ۲۰ | * | * | * |
| وئو ۳.۱ | ۲ | * | ۱۰ | * |
| وئو ۳.۱ سریع | ۲ | * | ۱۰ | * |
| وئو ۳ | ۲ | * | ۱۰ | * |
| وئو ۳ سریع | ۲ | * | ۱۰ | * |
| وئو ۲ | ۲ | * | ۵۰ | * |
| مدل‌های دیگر | ||||
| جما ۳ و ۳n | ۳۰ | ۱۵۰۰۰ | ۱۴,۴۰۰ | * |
| جاسازی جمینی | ۳۰۰۰ | ۱,۰۰۰,۰۰۰ | * | * |
| پیش‌نمایش Gemini Robotics-ER 1.5 | ۳۰۰ | ۱,۰۰۰,۰۰۰ | ۱۰۰۰۰ | * |
| پیش‌نمایش استفاده از کامپیوتر Gemini 2.5 | ۱۵۰ | ۲،۰۰۰،۰۰۰ | ۱۰۰۰۰ | * |
| مدل‌های منسوخ‌شده | ||||
| فلش جمینی ۱.۵ (منسوخ شده) | ۲۰۰۰ | ۴،۰۰۰،۰۰۰ | * | * |
| جمینی ۱.۵ فلش-۸بی (منسوخ شده) | ۴۰۰۰ | ۴،۰۰۰،۰۰۰ | * | * |
| جمینی ۱.۵ پرو (منسوخ شده) | ۱۰۰۰ | ۴،۰۰۰،۰۰۰ | * | * |
ردیف ۲
| مدل | دور در دقیقه | تی پی ام | آر پی دی | توکن‌های دسته‌ای در صف قرار داده شده |
|---|---|---|---|---|
| مدل‌های متن‌محور | ||||
| جمینی ۲.۵ پرو | ۱۰۰۰ | ۵،۰۰۰،۰۰۰ | ۵۰،۰۰۰ | ۵۰۰،۰۰۰،۰۰۰ |
| فلش جمینی ۲.۵ | ۲۰۰۰ | ۳،۰۰۰،۰۰۰ | ۱۰۰۰۰۰ | ۴۰۰،۰۰۰،۰۰۰ |
| پیش‌نمایش فلش Gemini 2.5 | ۲۰۰۰ | ۳،۰۰۰،۰۰۰ | ۱۰۰۰۰۰ | ۴۰۰،۰۰۰،۰۰۰ |
| جمینی ۲.۵ فلش-لایت | ۱۰۰۰۰ | ۱۰،۰۰۰،۰۰۰ | * | ۵۰۰،۰۰۰،۰۰۰ |
| پیش‌نمایش Gemini 2.5 Flash-Lite | ۱۰۰۰۰ | ۱۰،۰۰۰،۰۰۰ | * | ۵۰۰،۰۰۰،۰۰۰ |
| فلش جمینی ۲.۰ | ۱۰۰۰۰ | ۱۰،۰۰۰،۰۰۰ | * | ۱,۰۰۰,۰۰۰,۰۰۰ |
| جمینی ۲.۰ فلش-لایت | ۲۰،۰۰۰ | ۱۰،۰۰۰،۰۰۰ | * | ۱,۰۰۰,۰۰۰,۰۰۰ |
| API زنده | ||||
| جمینی ۲.۵ فلش لایو | ۱۰۰۰ جلسه | ۱۰،۰۰۰،۰۰۰ | * | * |
| پیش‌نمایش فلش Gemini 2.5 با صدای بومی | ۱۰۰ جلسه | ۱,۰۰۰,۰۰۰ | * | * |
| جمینی ۲.۰ فلش لایو | ۱۰۰۰ جلسه | ۱۰،۰۰۰،۰۰۰ | * | * |
| مدل‌های تولید چندوجهی | ||||
| پیش‌نمایش فلش Gemini 2.5 TTS | ۱۰۰۰ | ۱۰۰۰۰۰ | ۱۰۰۰۰ | * |
| پیش‌نمایش Gemini 2.5 Pro TTS | ۱۰۰ | ۲۵۰۰۰ | ۱۰۰۰ | * |
| تصویر فلش Gemini 2.5 | ۲۰۰۰ | ۱,۵۰۰,۰۰۰ | ۵۰،۰۰۰ | * |
| تولید تصویر پیش‌نمایش فلش Gemini 2.0 | ۲۰۰۰ | ۳،۰۰۰،۰۰۰ | ۱۰۰۰۰۰ | * |
| ایمیج ۴ استاندارد/سریع | ۱۵ | * | ۱۰۰۰ | * |
| ایمیجن ۴ اولترا | ۱۰ | * | ۴۰۰ | * |
| تصویر ۳ | ۲۰ | * | * | * |
| وئو ۳.۱ | ۴ | * | ۵۰ | * |
| وئو ۳.۱ سریع | ۴ | * | ۵۰ | * |
| وئو ۳ | ۴ | * | ۵۰ | * |
| وئو ۳ سریع | ۴ | * | ۵۰ | * |
| وئو ۲ | ۲ | * | ۵۰ | * |
| مدل‌های دیگر | ||||
| جما ۳ و ۳n | ۳۰ | ۱۵۰۰۰ | ۱۴,۴۰۰ | * |
| جاسازی جمینی | ۵۰۰۰ | ۵،۰۰۰،۰۰۰ | * | * |
| پیش‌نمایش Gemini Robotics-ER 1.5 | ۴۰۰ | ۳،۰۰۰،۰۰۰ | ۱۰۰۰۰۰ | * |
| پیش‌نمایش استفاده از کامپیوتر Gemini 2.5 | ۱۰۰۰ | ۵،۰۰۰،۰۰۰ | ۵۰،۰۰۰ | * |
| مدل‌های منسوخ‌شده | ||||
| فلش جمینی ۱.۵ (منسوخ شده) | ۲۰۰۰ | ۴،۰۰۰،۰۰۰ | * | * |
| جمینی ۱.۵ فلش-۸بی (منسوخ شده) | ۴۰۰۰ | ۴،۰۰۰،۰۰۰ | * | * |
| جمینی ۱.۵ پرو (منسوخ شده) | ۱۰۰۰ | ۴،۰۰۰،۰۰۰ | * | * |
ردیف ۳
| مدل | دور در دقیقه | تی پی ام | آر پی دی | توکن‌های دسته‌ای در صف قرار داده شده |
|---|---|---|---|---|
| مدل‌های متن‌محور | ||||
| جمینی ۲.۵ پرو | ۲۰۰۰ | ۸،۰۰۰،۰۰۰ | * | ۱,۰۰۰,۰۰۰,۰۰۰ |
| فلش جمینی ۲.۵ | ۱۰۰۰۰ | ۸،۰۰۰،۰۰۰ | * | ۱,۰۰۰,۰۰۰,۰۰۰ |
| پیش‌نمایش فلش Gemini 2.5 | ۱۰۰۰۰ | ۸،۰۰۰،۰۰۰ | * | ۱,۰۰۰,۰۰۰,۰۰۰ |
| جمینی ۲.۵ فلش-لایت | ۳۰۰۰۰ | ۳۰،۰۰۰،۰۰۰ | * | ۱,۰۰۰,۰۰۰,۰۰۰ |
| پیش‌نمایش Gemini 2.5 Flash-Lite | ۳۰۰۰۰ | ۳۰،۰۰۰،۰۰۰ | * | ۱,۰۰۰,۰۰۰,۰۰۰ |
| فلش جمینی ۲.۰ | ۳۰۰۰۰ | ۳۰،۰۰۰،۰۰۰ | * | ۵،۰۰۰،۰۰۰،۰۰۰ |
| جمینی ۲.۰ فلش-لایت | ۳۰۰۰۰ | ۳۰،۰۰۰،۰۰۰ | * | ۵،۰۰۰،۰۰۰،۰۰۰ |
| API زنده | ||||
| جمینی ۲.۵ فلش لایو | ۱۰۰۰ جلسه | ۱۰،۰۰۰،۰۰۰ | * | * |
| پیش‌نمایش فلش Gemini 2.5 با صدای بومی | ۱۰۰ جلسه | ۱,۰۰۰,۰۰۰ | * | * |
| جمینی ۲.۰ فلش لایو | ۱۰۰۰ جلسه | ۱۰،۰۰۰،۰۰۰ | * | * |
| مدل‌های تولید چندوجهی | ||||
| پیش‌نمایش فلش Gemini 2.5 TTS | ۱۰۰۰ | ۱,۰۰۰,۰۰۰ | * | * |
| پیش‌نمایش Gemini 2.5 Pro TTS | ۱۰۰ | ۱,۰۰۰,۰۰۰ | * | * |
| تصویر فلش Gemini 2.5 | ۵۰۰۰ | ۵،۰۰۰،۰۰۰ | * | * |
| تولید تصویر پیش‌نمایش فلش Gemini 2.0 | ۵۰۰۰ | ۵،۰۰۰،۰۰۰ | * | * |
| ایمیج ۴ استاندارد/سریع | ۲۰ | * | ۱۵۰۰۰ | * |
| ایمیجن ۴ اولترا | ۱۵ | * | ۵۰۰۰ | * |
| تصویر ۳ | ۲۰ | * | * | * |
| وئو ۳.۱ | ۱۰ | * | ۵۰۰ | * |
| وئو ۳.۱ سریع | ۱۰ | * | ۵۰۰ | * |
| وئو ۳ | ۱۰ | * | ۵۰۰ | * |
| وئو ۳ سریع | ۱۰ | * | ۵۰۰ | * |
| وئو ۲ | ۲ | * | ۵۰ | * |
| مدل‌های دیگر | ||||
| جما ۳ و ۳n | ۳۰ | ۱۵۰۰۰ | ۱۴,۴۰۰ | * |
| جاسازی جمینی | ۱۰۰۰۰ | ۱۰،۰۰۰،۰۰۰ | * | * |
| پیش‌نمایش Gemini Robotics-ER 1.5 | ۶۰۰ | ۸،۰۰۰،۰۰۰ | * | *۱,۰۰۰,۰۰۰,۰۰۰* |
| پیش‌نمایش استفاده از کامپیوتر Gemini 2.5 | ۲۰۰۰ | ۸،۰۰۰،۰۰۰ | * | * |
| مدل‌های منسوخ‌شده | ||||
| فلش جمینی ۱.۵ (منسوخ شده) | ۲۰۰۰ | ۴،۰۰۰،۰۰۰ | * | * |
| جمینی ۱.۵ فلش-۸بی (منسوخ شده) | ۴۰۰۰ | ۴،۰۰۰،۰۰۰ | * | * |
| جمینی ۱.۵ پرو (منسوخ شده) | ۱۰۰۰ | ۴،۰۰۰،۰۰۰ | * | * |
محدودیت‌های نرخ مشخص‌شده تضمین‌شده نیستند و ظرفیت واقعی ممکن است متفاوت باشد.
محدودیت‌های نرخ API دسته‌ای
درخواست‌های API دسته‌ای، جدا از فراخوانی‌های API غیر دسته‌ای، مشمول محدودیت‌های نرخ خاص خود هستند.
- درخواست‌های دسته‌ای همزمان: ۱۰۰
- محدودیت حجم فایل ورودی: ۲ گیگابایت
- محدودیت ذخیره‌سازی فایل: ۲۰ گیگابایت
- توکن‌های صف‌بندی‌شده برای هر مدل: ستون توکن‌های صف‌بندی‌شده‌ی دسته‌ای در جدول محدودیت‌های نرخ، حداکثر تعداد توکن‌هایی را که می‌توانند برای پردازش دسته‌ای در تمام کارهای دسته‌ای فعال شما برای یک مدل معین صف‌بندی شوند، فهرست می‌کند. به جدول محدودیت‌های نرخ استاندارد API مراجعه کنید.
نحوه ارتقا به سطح بالاتر
رابط برنامه‌نویسی نرم‌افزار Gemini از Cloud Billing برای تمام سرویس‌های پرداخت استفاده می‌کند. برای انتقال از سطح رایگان به سطح پولی، ابتدا باید Cloud Billing را برای پروژه Google Cloud خود فعال کنید.
زمانی که پروژه شما معیارهای مشخص شده را برآورده کند، واجد شرایط ارتقاء به سطح بالاتر می‌شود. برای درخواست ارتقاء، این مراحل را دنبال کنید:
- به صفحه کلیدهای API در AI Studio بروید.
- پروژه‌ای را که می‌خواهید ارتقا دهید پیدا کنید و روی «ارتقا» کلیک کنید. گزینه «ارتقا» فقط برای پروژه‌هایی نمایش داده می‌شود که شرایط سطح بعدی را برآورده می‌کنند.
پس از اعتبارسنجی سریع، پروژه به سطح بعدی ارتقا می‌یابد.
درخواست افزایش سقف نرخ
هر مدل دارای محدودیت سرعت مرتبط (تعداد درخواست در دقیقه، RPM) است. برای جزئیات بیشتر در مورد این محدودیت‌های سرعت، به مدل‌های Gemini مراجعه کنید.
درخواست افزایش سقف نرخ ردیف پولی
ما هیچ تضمینی در مورد افزایش سقف نرخ شما ارائه نمی‌دهیم، اما تمام تلاش خود را برای بررسی درخواست شما خواهیم کرد.