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

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

هنگام استفاده از Firebase AI Logic برای ارسال درخواست به مدل‌های Gemini و Imagen ، محدودیت‌های نرخ پروژه شما به ارائه‌دهنده " Gemini API " انتخابی شما بستگی دارد. Firebase AI Logic همچنین راهی برای تعیین محدودیت‌های نرخ "به ازای هر کاربر" ارائه می‌دهد.

مشاهده محدودیت‌های نرخ برای API توسعه‌دهندگان Gemini

نحوه عملکرد محدودیت‌های نرخ (سهمیه‌ها)

محدودیت‌های نرخ (سهمیه‌ها) در چهار بُعد اندازه‌گیری می‌شوند:

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

میزان استفاده شما در مقایسه با هر محدودیت ارزیابی می‌شود و تجاوز از هر یک از آنها باعث ایجاد خطای 429 quota-exceeded می‌شود. به عنوان مثال، اگر محدودیت RPM شما 20 باشد، ارسال 21 درخواست در عرض یک دقیقه منجر به خطا خواهد شد، حتی اگر از TPM یا سایر محدودیت‌های خود تجاوز نکرده باشید.

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

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

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

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

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

محدودیت‌های نرخ «به ازای هر کاربر» را تنظیم کنید

برای استفاده از Firebase AI Logic ، پروژه شما باید ارائه دهنده API انتخابی Gemini شما فعال باشد، اما همچنین باید Firebase AI Logic API را نیز فعال کنید، که به عنوان دروازه‌ای بین SDK های کلاینت ما و ارائه دهنده API Gemini شما عمل می‌کند. این API هنگام راه‌اندازی اولیه Firebase AI Logic در پروژه Firebase شما فعال می‌شود.

شما می‌توانید از محدودیت نرخ (سهمیه) API مربوط به Firebase AI Logic به عنوان یک محدودیت نرخ "به ازای هر کاربر" برای برنامه خود ، به ویژه برای ویژگی‌های هوش مصنوعی که به Firebase AI Logic متکی هستند، استفاده کنید. شما باید این محدودیت را طوری تنظیم کنید که به طور منطقی امکان دسترسی یک کاربر به ویژگی‌های هوش مصنوعی شما را فراهم کند، در عین حال اطمینان حاصل کنید که هیچ کاربر واحدی از محدودیت‌های ارائه دهنده API Gemini شما (که قرار است توسط همه کاربران شما به اشتراک گذاشته شود) فراتر نرود.

جزئیات مربوط به محدودیت نرخ «به ازای هر کاربر»

در اینجا جزئیات مهمی در مورد محدودیت‌های نرخ (سهمیه‌ها) API مربوط به Firebase AI Logic -- به طور خاص، درخواست‌ها در هر دقیقه (RPM) -- آورده شده است:

• این بر اساس «ایجاد درخواست محتوا» بر اساس هر کاربر، هر منطقه، هر دقیقه است و بر اساس مدل نیست .

• این محدودیت سرعت برای همه کاربران شما اعمال می‌شود. در حال حاضر، راهی برای تعیین محدودیت سرعت برای یک کاربر خاص یا گروه خاصی از کاربران وجود ندارد ^.

• این در سطح پروژه اعمال می‌شود و برای همه برنامه‌ها و آدرس‌های IP که از آن پروژه Firebase استفاده می‌کنند، اعمال می‌شود.

• این مورد برای هر فراخوانی که به طور خاص از هر Firebase AI Logic SDK می‌آید، اعمال می‌شود.

• محدودیت سرعت پیش‌فرض برای هر کاربر ۱۰۰ دور در دقیقه است.
  توجه داشته باشید که شما هنوز باید محدودیت‌های ارائه‌دهنده‌ی API Gemini خود (به بالا مراجعه کنید) را در نظر بگیرید، که بر API منطق هوش مصنوعی Firebase اولویت دارند.

^{* اگر از API مربوط به Vertex AI Gemini استفاده می‌کنید و برنامه شما کاربران را به مناطق مختلف هدایت می‌کند (برای مثال، با استفاده از Firebase Remote Config )، می‌توانید برای کاربران در یک منطقه خاص، محدودیت نرخ مشخصی تعیین کنید.}

محدودیت نرخ «به ازای هر کاربر» را تنظیم کنید

برای تنظیم محدودیت نرخ (سهمیه)، باید مجوز serviceusage.quotas.update را داشته باشید که به طور پیش‌فرض در نقش مالک و ویرایشگر گنجانده شده است.

در اینجا نحوه ویرایش سقف نرخ (سهمیه) یا درخواست افزایش آن آمده است:

1. در کنسول Google Cloud ، به صفحه مربوط به API مربوط به Firebase AI Logic بروید.

2. روی مدیریت کلیک کنید.

3. در پایین صفحه، روی برگه «Quotas & System Limits» کلیک کنید.

4. جدول را فیلتر کنید تا سهمیه‌های مورد علاقه، مانند قابلیت (درخواست‌ها برای تولید محتوا) و منطقه را نشان دهید.

   برای مثال، برای مشاهده سهمیه هر کاربر برای تولید درخواست محتوا در هر یک از مناطق آسیایی پشتیبانی شده، فیلتر شما شبیه به این خواهد بود: Generate content requests + Dimension:region:asia

5. کادر انتخاب سمت چپ هر سهمیه مورد نظر را انتخاب کنید.

6. در انتهای ردیف سهمیه، روی more_vert کلیک کنید و سپس ویرایش سهمیه را انتخاب کنید.

7. در فرم تغییرات سهمیه ، موارد زیر را انجام دهید:

   1. سهمیه افزایش یافته را در فیلد مقدار جدید وارد کنید.

      این سهمیه در سطح پروژه اعمال می‌شود و بین تمام برنامه‌ها و آدرس‌های IP که از آن پروژه Firebase استفاده می‌کنند، به اشتراک گذاشته می‌شود.

   2. فیلدهای اضافی موجود در فرم را تکمیل کنید و سپس روی «انجام شد» کلیک کنید.

   3. روی ارسال درخواست کلیک کنید.