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

برای مشاهده محتوا و کد ارائه دهنده خاص در این صفحه، روی ارائه دهنده API Gemini خود کلیک کنید.


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

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

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

محدودیت نرخ (سهمیه) چگونه کار می کند

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

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

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

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

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

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

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

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

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

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

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

جزئیات در مورد محدودیت نرخ "به ازای هر کاربر".

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

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

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

  • این برای هر تماسی که به طور خاص از هر Firebase AI Logic SDK انجام می شود اعمال می شود.

  • محدودیت سرعت پیش فرض 100 RPM برای هر کاربر است.
    توجه داشته باشید که همچنان باید محدودیت‌هایی را برای ارائه‌دهنده API Gemini خود در نظر بگیرید (به بالا مراجعه کنید)، که بر Firebase AI Logic API اولویت دارند.

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

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

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

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

  2. روی Manage کلیک کنید.

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

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

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

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

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

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

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

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

    2. هر فیلد اضافی را در فرم تکمیل کنید و سپس روی Done کلیک کنید.

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