حدود المعدّلات والحصص

انقر على مزوّد Gemini API لعرض المحتوى والرمز الخاصين بالمزوّد على هذه الصفحة.


تتحكّم حدود المعدّل (المعروفة باسم الحصص) في عدد الطلبات التي يمكنك إرسالها إلى Gemini API خلال إطار زمني محدّد. تساعد هذه الحدود في ضمان الاستخدام العادل والحماية من إساءة الاستخدام والحفاظ على أداء النظام لجميع المستخدمين.

عند استخدام Firebase AI Logic للوصول إلى نماذج Gemini، تعتمد حدود المعدّل في مشروعك على مقدّم خدمة Gemini API الذي اخترته. توفّر Firebase AI Logic أيضًا طريقة لضبط حدود المعدل "لكل مستخدم".

عرض حدود المعدّل في Gemini Developer API

إذا تجاوزت الحصة المخصّصة لك أو إذا تم استنفاد سعة النموذج الذي تحاول الوصول إليه، ستتلقّى رسالة الخطأ 429.

طريقة عمل حدود المعدّل (الحصص)

يتم قياس حدود المعدّل (الحصص) على مستوى أربعة أبعاد:

  • الطلبات في الدقيقة (RPM)
  • الطلبات في اليوم (RPD)
  • الرموز المميزة في الدقيقة (TPM)
  • الرموز المميزة في اليوم (TPD)

يتم تقييم معدّل استخدامك مقارنةً بكل حد، وسيؤدي تجاوز أي حد إلى ظهور الخطأ 429 الذي يشير إلى تجاوز الحصة. على سبيل المثال، إذا كان الحد الأقصى لعدد الطلبات في الدقيقة هو 20، سيؤدي تقديم 21 طلبًا خلال دقيقة واحدة إلى حدوث خطأ، حتى إذا لم تتجاوز الحد الأقصى لعدد الطلبات في الدقيقة أو الحدود الأخرى.

يتم تطبيق حدود المعدّل على مستوى المشروع، وهي تنطبق على جميع التطبيقات وعناوين IP التي تستخدم مشروع Firebase هذا.

تختلف الحدود القصوى حسب النموذج المحدّد المستخدَم، ولا تنطبق بعض الحدود إلا على نماذج معيّنة.

تكون حدود الاستخدام أكثر تقييدًا للنماذج التجريبية ونماذج المعاينة.

طلب زيادة الحدّ الأقصى لمعدّل الطلبات

إذا كنت تستخدم "فئة مدفوعة" من Gemini Developer API، يمكنك طلب زيادة الحدّ الأقصى للمعدّل.

ضبط حدود المعدّل "لكل مستخدم"

لاستخدام Firebase AI Logic، يجب تفعيل موفّر Gemini API الذي اخترته في مشروعك، ولكن يجب أيضًا تفعيل واجهة برمجة التطبيقات Firebase AI Logic التي تعمل كبوابة بين حِزم SDK الخاصة بالعميل وموفّر Gemini API. يتم تفعيل واجهة برمجة التطبيقات هذه عند إعداد Firebase AI Logic في مشروعك على Firebase للمرة الأولى.

يمكنك استخدام الحدّ الأقصى لعدد طلبات البيانات من واجهة برمجة التطبيقات Firebase AI Logic (الحصة) كحدّ أقصى لعدد الطلبات "لكل مستخدم" في تطبيقك، وتحديدًا لميزات تستخدم الذكاء الاصطناعي التي تعتمد على Firebase AI Logic. عليك ضبط هذا الحدّ بما يتناسب مع استخدام مستخدم واحد لميزة تستخدم الذكاء الاصطناعي، مع ضمان عدم تجاوز أي مستخدم واحد لحدود مزوّد Gemini API (المخصّص لمشاركة جميع المستخدمين).

تفاصيل حول الحد الأقصى لمعدّل الإرسال "لكل مستخدم"

في ما يلي بعض التفاصيل المهمة حول حدود معدّل طلبات واجهة برمجة التطبيقات Firebase AI Logic (الحصص)، وتحديدًا الطلبات في الدقيقة (RPM):

  • ويستند إلى "طلبات إنشاء المحتوى" وليس إلى النموذج، وذلك على أساس كل مستخدم وكل منطقة وكل دقيقة.

  • وهو الحد الأقصى للمعدل الذي يتم تطبيقه على جميع المستخدمين. في الوقت الحالي، لا تتوفّر طريقة لضبط الحدّ الأقصى لعدد الطلبات لمستخدم معيّن أو مجموعة محدّدة من المستخدمين*.

  • ويتم تطبيقها على مستوى المشروع، كما يتم تطبيقها على جميع التطبيقات وعناوين IP التي تستخدم مشروع Firebase هذا.

  • وينطبق ذلك على أي طلب يأتي تحديدًا من أي Firebase AI Logic حزمة تطوير برامج (SDK).

  • الحدّ الأقصى التلقائي لمعدّل الطلبات هو 100 طلب في الدقيقة لكل مستخدم.
    يُرجى العِلم أنّه عليك مراعاة الحدود التي يفرضها مقدّم خدمة Gemini API (راجِع ما ورد أعلاه)، والتي لها الأولوية على واجهة برمجة التطبيقات Firebase AI Logic.

* إذا كنت تستخدم Agent Platform Gemini API (formerly Vertex AI) وكان تطبيقك يوجّه المستخدمين إلى مناطق مختلفة (على سبيل المثال، باستخدام Firebase Remote Config)، يمكنك ضبط حدّ معدّل استخدام معيّن للمستخدمين في منطقة معيّنة.

تعديل الحد الأقصى لمعدل الإرسال "لكل مستخدم"

لتعديل الحدّ الأقصى لعدد الطلبات (الحصة)، يجب أن يكون لديك إذن serviceusage.quotas.update، وهو مضمّن تلقائيًا في دورَي "المالك" و"المحرِّر".

في ما يلي كيفية تعديل الحدّ الأقصى لعدد الطلبات (الحصة) أو طلب زيادته:

  1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة Firebase AI Logic API.

  2. انقر على إدارة.

  3. في أسفل الصفحة، انقر على علامة التبويب الحصص وحدود النظام.

  4. فلتر الجدول لعرض الحصص التي تهمّك، مثل القدرة (طلبات إنشاء المحتوى) والمنطقة.

    على سبيل المثال، لعرض الحصص المخصّصة لكل مستخدم لإنشاء طلبات محتوى في أي من المناطق الآسيوية المتوافقة، سيبدو الفلتر مشابهاً لما يلي: Generate content requests + Dimension:region:asia

  5. ضَع علامة في مربّع الاختيار على يمين كل حصة تهمّك.

  6. في نهاية صف الحصة، انقر على ، ثم اختَر تعديل الحصة.

  7. في نموذج تغييرات الحصة، اتّبِع الخطوات التالية:

    1. أدخِل الحصة المتزايدة في حقل القيمة الجديدة.

      تنطبق هذه الحصة على مستوى المشروع ويتمّ مشاركتها بين جميع التطبيقات وعناوين IP التي تستخدم مشروع Firebase هذا.

    2. أكمِل أي حقول إضافية في النموذج، ثم انقر على تم.

    3. انقر على إرسال الطلب.