|
روی ارائه‌دهنده Gemini API خود کلیک کنید تا محتوا و کد مخصوص ارائه‌دهنده را در این صفحه مشاهده کنید. |
محدودیت‌های نرخ (که معمولاً سهمیه نامیده می‌شوند) تعداد درخواست‌هایی را که می‌توانید در یک بازه زمانی مشخص به Gemini API ارسال کنید تنظیم می‌کنند. این محدودیت‌ها به تضمین استفاده منصفانه، محافظت دربرابر سوءاستفاده، و کمک به حفظ عملکرد سیستم برای همه کاربران کمک می‌کند.
هنگام استفاده از Firebase AI Logic برای دسترسی به مدل‌های Gemini، حدود نرخ پروژه شما به ارائه‌دهنده Gemini API انتخابی شما بستگی دارد. Firebase AI Logic همچنین روشی برای تنظیم محدودیت‌های نرخ «به‌ازای هر کاربر» ارائه می‌دهد.
مشاهده محدودیت‌های نرخ برای Gemini Developer API
اگر از سهمیه خود فراتر بروید یا ظرفیت مدل مورد دسترسی شما تمام شود، پیام خطای ۴۲۹ دریافت خواهید کرد.
نحوه عملکرد حدود نرخ (سهمیه‌ها)
حدود نرخ (سهمیه‌ها) در چهار بُعد اندازه‌گیری می‌شوند:
- درخواست‌ها در دقیقه (RPM)
- درخواست‌ها در روز (RPD)
- داده‌واحد در دقیقه (TPM)
- تعداد کدها در روز (TPD)
استفاده شما دربرابر هر محدودیت ارزیابی می‌شود و فراتر رفتن از هریک از آن‌ها باعث خطای ۴۲۹ «سهمیه تمام شده است» می‌شود. برای مثال، اگر حد مجاز درخواست‌های شما در دقیقه ۲۰ باشد، ارسال ۲۱ درخواست در یک دقیقه منجر به خطا خواهد شد، حتی اگر از حد مجاز درخواست‌های شما در دقیقه یا سایر حدود مجاز فراتر نرفته باشید.
محدودیت‌های نرخ در سطح پروژه اعمال می‌شوند و بر همه برنامه‌ها و نشانی‌های IP که از آن پروژه Firebase استفاده می‌کنند اعمال می‌شوند.
محدودیت‌ها بسته به مدل خاص مورد استفاده متفاوت است و برخی‌از محدودیت‌ها فقط برای مدل‌های خاص اعمال می‌شود.
حد نرخ برای مدل‌های آزمایشی و پیش‌نمایش محدودتر است.
درخواست افزایش حد نرخ
اگر در یک «سطح پولی» برای Gemini Developer API هستید، می‌توانید درخواست افزایش حد نرخ کنید.
تنظیم محدودیت‌های نرخ «به‌ازای هر کاربر»
برای استفاده از Firebase AI Logic، پروژه شما باید ارائه‌دهنده Gemini API انتخابی‌تان را فعال کرده باشد، اما باید میانای برنامه‌سازی کاربردی Firebase AI Logic را نیز فعال کنید که به‌عنوان دروازه بین کیت‌های توسعه نرم‌افزار کارخواه ما و ارائه‌دهنده Gemini API شما عمل می‌کند. این «میانای برنامه‌سازی کاربردی» زمانی برای شما فعال می‌شود که در ابتدا Firebase AI Logic را در پروژه Firebase خود راه‌اندازی کنید.
می‌توانید از حد نرخ (سهمیه) Firebase AI Logic API به‌عنوان حد نرخ «به‌ازای هر کاربر» برای برنامه‌تان، به‌طور خاص برای ویژگی‌های هوش مصنوعی که به Firebase AI Logic متکی هستند، استفاده کنید. شما باید این حد را تنظیم کنید تا به‌طور معقولی دسترسی یک کاربر به ویژگی‌های هوش مصنوعی شما را فراهم کند، درحالی‌که همچنین مطمئن شوید که هیچ کاربری از حدود ارائه‌دهنده Gemini API شما فراتر نمی‌رود (که قرار است بین همه کاربران شما تقسیم شود).
جزئیات مربوط به حد نرخ «به‌ازای هر کاربر»
در اینجا چند جزئیات مهم درباره Firebase AI Logic API حدود نرخ (سهمیه‌ها) -- به‌طور خاص، درخواست‌ها در دقیقه (RPM) آورده شده است:
این محدودیت براساس «درخواست‌های تولید محتوا» به‌صورت کاربر به کاربر، منطقه به منطقه، و دقیقه به دقیقه است و براساس مدل نیست.
این حد نرخ برای همه کاربران شما اعمال می‌شود. درحال‌حاضر، راهی برای تنظیم حد نرخ برای یک کاربر خاص یا گروه خاصی از کاربران وجود ندارد*.
این تنظیم در سطح پروژه اعمال می‌شود و بر همه برنامه‌ها و نشانی‌های IP که از آن پروژه Firebase استفاده می‌کنند اعمال می‌شود.
این خط‌مشی برای هر تماسی که به‌طور خاص از هریک از Firebase AI Logic کیت‌های توسعه نرم‌افزار می‌آید اعمال می‌شود.
محدودیت نرخ پیش‌فرض ۱۰۰ دور در دقیقه برای هر کاربر است.
توجه داشته باشید که همچنان باید محدودیت‌های ارائه‌دهنده Gemini API خود را درنظر بگیرید (به بالا مراجعه کنید)، که بر Firebase AI Logic API اولویت دارد.
* اگر از Agent Platform Gemini API (formerly Vertex AI) استفاده می‌کنید و برنامه شما کاربران را به مناطق مختلف هدایت می‌کند (برای مثال، بااستفاده از Firebase Remote Config)، می‌توانید حد نرخ مشخصی برای کاربران در یک منطقه خاص تنظیم کنید.
تنظیم حد نرخ «به‌ازای هر کاربر»
برای تنظیم حد نرخ (سهمیه)، باید اجازه serviceusage.quotas.update
داشته باشید که به‌طور پیش‌فرض در نقش «مالک» و «ویرایشگر» گنجانده شده است.
در اینجا نحوه ویرایش حد مجاز (سهمیه) یا درخواست افزایش آن آورده شده است:
در کنسول Google Cloud، به صفحه Firebase AI Logic میانای برنامه‌سازی کاربردی بروید.
روی مدیریت کلیک کنید؛
در پایین صفحه، روی برگه سهمیه‌ها و محدودیت‌های سیستم کلیک کنید.
جدول را فیلتر کنید تا سهمیه‌های موردنظر، مانند قابلیت (درخواست‌های تولید محتوا) و منطقه را نشان دهد.
برای مثال، برای مشاهده سهمیه‌های هر کاربر برای تولید درخواست‌های محتوا در هریک از مناطق آسیایی پشتیبانی‌شده، فیلتر شما شبیه به این خواهد بود:
Generate content requests+Dimension:region:asiaچارگوش انتخاب در سمت راست هر سهمیه موردنظر را علامت بزنید.
در انتهای ردیف سهمیه، روی کلیک کنید، و سپس ویرایش سهمیه را انتخاب کنید.
در فرم تغییرات سهمیه، موارد زیر را انجام دهید:
سهمیه افزایش‌یافته را در فیلد مقدار جدید وارد کنید.
این سهمیه در سطح پروژه اعمال می‌شود و در همه برنامه‌ها و نشانی‌های IP که از آن پروژه Firebase استفاده می‌کنند مشترک است.
فیلدهای اضافی در فرم را تکمیل کنید و سپس روی تمام کلیک کنید.
روی ارسال درخواست کلیک کنید.