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

انقر على مزوّد 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 API، التي تعمل كبوابة بين حِزم تطوير البرامج (SDK) للعملاء وموفِّرGemini API. يتم تفعيل واجهة برمجة التطبيقات هذه لك عند إعداد Firebase AI Logic في مشروعك على Firebase في البداية.

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

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

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

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

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

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

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