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

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

مشاهده محدودیت‌های نرخ فعال در AI Studio

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

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

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

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

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

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

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

حدود نرخ مبتنی بر هزینه

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

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

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

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

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

سطوح استفاده

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

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

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

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

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

حدود نرخ Gemini API

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

مشاهده محدودیت‌های نرخ فعال در AI Studio

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

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

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

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

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

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

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

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

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

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

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

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

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