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

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


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

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

عرض حدود المعدّل لواجهة برمجة التطبيقات Gemini Developer API

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

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

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

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

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

تختلف الحدود القصوى حسب الطراز المحدّد المستخدَم، ولا تنطبق بعض الحدود إلا على طُرز محدّدة. على سبيل المثال، يتم احتساب عدد الصور في الدقيقة (IPM) فقط للنماذج القادرة على إنشاء الصور (Imagen 3)، ولكنها تشبه من الناحية النظرية عدد الرموز المميزة في الدقيقة (TPM).

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

طلب زيادة حدّ المعدّل

إذا كنت تستخدم "فئة مدفوعة" من 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:

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

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

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

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

تعديل الحدّ الأقصى لعدد الطلبات "لكل مستخدم"

لتعديل الحدّ الأقصى لعدد الطلبات (الحصة)، يجب أن يكون لديك إذن 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. انقر على إرسال الطلب.