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

انقر على مزوّد خدمة 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 هذا.

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

  • الحدّ الأقصى التلقائي لمعدّل الإرسال هو 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.

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

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

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

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

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

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

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

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

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

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

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