محدودیت‌های نرخ

حدود نرخ تعداد درخواست‌هایی را که می‌توانید در یک بازه زمانی مشخص به Gemini API ارسال کنید تنظیم می‌کند. این محدودیت‌ها به حفظ استفاده منصفانه، محافظت دربرابر سوءاستفاده، و کمک به حفظ عملکرد سیستم برای همه کاربران کمک می‌کند.

مشاهده محدودیت‌های نرخ فعال در «استودیو هوش مصنوعی»

نحوه عملکرد حدود نرخ

حدود نرخ معمولاً در سه بعد اندازه‌گیری می‌شوند:

• درخواست در دقیقه (درخواست در دقیقه)
• تعداد نشان در دقیقه (ورودی) (TPM)
• درخواست‌ها در روز (RPD)

استفاده شما دربرابر هر محدودیت ارزیابی می‌شود و فراتر رفتن از هریک از آن‌ها باعث خطای محدودیت نرخ می‌شود. برای مثال، اگر حد «درآمد به‌ازای هر هزار بازدید» شما ۲۰ باشد، انجام ۲۱ درخواست در یک دقیقه منجر به خطا خواهد شد، حتی اگر از حد «درخواست در هر دقیقه» یا سایر حدود خود فراتر نرفته باشید.

محدودیت‌های نرخ بر هر پروژه اعمال می‌شود، نه بر هر کلید API. درخواست‌ها در روز (RPD) سهمیه‌ها در نیمه‌شب به وقت اقیانوس آرام بازنشانی می‌شوند.

محدودیت‌ها بسته به مدل خاص مورد استفاده متفاوت است و برخی‌از محدودیت‌ها فقط برای مدل‌های خاص اعمال می‌شود. برای مثال، «تصاویر در دقیقه» یا IPM فقط برای مدل‌هایی محاسبه می‌شود که قابلیت تولید تصویر دارند (Nano Banana)، اما ازنظر مفهومی مشابه TPM است. مدل‌های دیگر ممکن است محدودیت تعداد نشان در روز (TPD) داشته باشند.

حد نرخ برای مدل‌های آزمایشی و پیش‌نمایش محدودتر است.

حدود نرخ براساس هزینه

علاوه‌بر محدودیت‌های درخواست در دقیقه (RPM) و تعداد نشان در دقیقه (TPM)، Gemini API محدودیت‌های نرخ مبتنی بر هزینه را برای محافظت دربرابر هزینه‌های غیرمنتظره اعمال می‌کند. اینکه این محدودیت‌ها برای حساب شما اعمال شود یا نه به سابقه صورت‌حساب و سطح استفاده شما بستگی دارد.

جدول زیر محدودیت‌های نرخ براساس هزینه را برای هر سطح استفاده نشان می‌دهد. این محدودیت‌ها در یک بازه زمانی ۱۰ دقیقه‌ای ارزیابی می‌شوند. اینکه این محدودیت‌ها برای حساب شما اعمال شود یا نه به سابقه صورت‌حساب و وضعیت حساب شما بستگی دارد.

سطح استفاده	حد مجاز نرخ هزینه (در هر ۱۰ دقیقه)
Free	موجود نیست
سطح ۱	۱۰ دلار امریکا
سطح ۲	۵۰
سطح ۳	۲۰۰

اگر به حد مجاز بسامد براساس هزینه برسید، API 429 RESOURCE_EXHAUSTED خطایی برمی‌گرداند. برای حل‌وفصل این مشکل:

• پس‌از مدت کوتاهی صبر کنید و دوباره امتحان کنید.
• نرخ درخواست‌های پرهزینه را کاهش دهید، برای مثال بااستفاده از پنجره‌های زمینه‌ای کوچک‌تر یا بروندادهای کوتاه‌تر.
• اگر به‌طور مداوم درطول استفاده عادی به این حد مجاز می‌رسید، درخواست افزایش حد مجاز نرخ ارسال کنید.

سطوح استفاده

حدود نرخ به سطح استفاده پروژه مرتبط است. با افزایش استفاده و هزینه API، به‌طور خودکار به سطح بالاتری با محدودیت‌های نرخ افزایش‌یافته ارتقا خواهید یافت.

شرایط صلاحیت برای «سطوح ۲ و ۳» براساس کل هزینه تجمعی در سرویس‌های Google Cloud (شامل، اما نه محدود به، Gemini API) برای حساب صورت‌حساب پیوندشده به پروژه شما است.

سطح استفاده	انتخابی	سقف سطح صورت‌حساب
Free	پروژه فعال یا دوره آزمایشی رایگان	موجود نیست
سطح ۱	راه‌اندازی و پیوند دادن حساب صورت‌حساب فعال	۲۵۰
سطح ۲	‫۱۰۰ دلار + ۳ روز از اولین پرداخت موفق	۲۰۰۰ دلار
سطح ۳	‫۱٬۰۰۰ دلار + ۳۰ روز از اولین پرداخت موفق	‫۲۰٬۰۰۰ تا ۱۰۰٬۰۰۰ دلار به‌بالا

اگرچه برآورده کردن معیارهای صلاحیت ذکرشده معمولاً برای تأیید کافی است، اما در موارد نادر ممکن است درخواست ارتقا براساس عوامل دیگری که درطول فرایند بررسی شناسایی می‌شوند رد شود.

این سیستم به حفظ امنیت و تمامیت پلاتفرم Gemini API برای همه کاربران کمک می‌کند.

حدود نرخ Gemini API

حد نرخ به عوامل مختلفی (مثل سطح استفاده شما) بستگی دارد و می‌توانید آن را در Google AI Studio مشاهده کنید. با تغییر سطح و وضعیت حساب شما در طول زمان، محدودیت‌های نرخ شما به‌طور خودکار به‌روزرسانی خواهد شد.

مشاهده محدودیت‌های نرخ فعال در «استودیو هوش مصنوعی»

حدود نرخ مشخص‌شده تضمین نمی‌شود و ظرفیت واقعی ممکن است متفاوت باشد.

حد نرخ استنباط اولویت‌دار

مصرف اولویت‌دار نرخ حدود خود را حفظ می‌کند، حتی اگر مصرف در حدود نرخ کلی ترافیک تعاملی محاسبه شود. محدودیت‌های نرخ پیش‌فرض عبارت‌اند از: ۰٫۳ برابر محدودیت نرخ استاندارد برای هر مدل و سطح

حد نرخ میانای برنامه‌سازی کاربردی دسته‌ای

درخواست‌های Batch API تابع محدودیت‌های نرخ خود هستند که از تماس‌های غیر دسته‌ای API جدا هستند.

• درخواست‌های دسته‌ای هم‌زمان: ۱۰۰
• محدودیت اندازه فایل ورودی: ۲ گیگابایت
• محدودیت فضای ذخیره‌سازی فایل: ۲۰ گیگابایت
• کدهای درصف برای هر مدل: جدول کدهای درصف دسته‌ای حداکثر تعداد کدهایی را که می‌توان برای پردازش دسته‌ای در همه کارهای دسته‌ای فعال شما برای یک مدل معین درصف قرار داد فهرست می‌کند.

نحوه ارتقا به سطح بعدی

برای انتقال از سطح «رایگان» به سطح پولی، ابتدا باید صدور صورت‌حساب را در «استودیوِ هوش مصنوعی» راه‌اندازی کنید.

وقتی پروژه‌تان معیارهای مشخص‌شده را برآورده کند، به‌طور خودکار به سطح بعدی ارتقا خواهد یافت. ارتقاهای سطح از «رایگان» به «سطح ۱» معمولاً بلافاصله اعمال می‌شوند و ارتقاهای سطح بعدی ظرف ۱۰ دقیقه اعمال خواهند شد. برای بررسی سطوح خود، به صفحه پروژه‌ها در AI Studio بروید.

درخواست افزایش حد نرخ

هر مدل تغییرات دارای حد نرخ مرتبط (درخواست در دقیقه، دور در دقیقه) است. برای جزئیات مربوط به این محدودیت‌های نرخ، صفحه محدودیت نرخ «استودیو هوش مصنوعی» را ببینید.

درخواست افزایش حد نرخ سطح پولی

ما هیچ تضمینی درباره افزایش حد نرخ شما ارائه نمی‌دهیم، اما تمام تلاش خود را برای بررسی درخواست شما خواهیم کرد.