|
انقر على مقدّم Gemini API لعرض المحتوى والرمز البرمجي الخاصَّين بالمقدّم على هذه الصفحة. |
تنظّم الحدود القصوى لمعدّل الاستخدام (المعروفة باسم الحصص) عدد الطلبات التي يمكنك إرسالها إلى Gemini API خلال إطار زمني معيّن. تساعد هذه الحدود في ضمان الاستخدام العادل والحماية من إساءة الاستخدام والمساعدة في الحفاظ على أداء النظام لجميع المستخدمين.
عند استخدام Firebase AI Logic لإرسال طلبات إلى Gemini و Imagen نماذج، تعتمد الحدود القصوى لمعدّل الاستخدام في مشروعك على مقدّم "Gemini API" الذي اخترته. Firebase AI Logic توفّر أيضًا طريقة لـ ضبط الحدود القصوى لمعدّل الاستخدام "لكل مستخدم".
عرض الحدود القصوى لمعدّل الاستخدام في Gemini Developer API
إذا تجاوزت حصتك أو تم استنفاد سعة النموذج الذي تحاول الوصول إليه، ستظهر رسالة الخطأ 429.
طريقة عمل الحدود القصوى لمعدّل الاستخدام (الحصص)
يتم قياس الحدود القصوى لمعدّل الاستخدام (الحصص) على أربعة أبعاد:
- الطلبات في الدقيقة (RPM)
- الطلبات في اليوم (RPD)
- الرموز المميّزة في الدقيقة (TPM)
- الرموز المميّزة في اليوم (TPD)
يتم تقييم استخدامك مقابل كل حدّ، وسيؤدي تجاوز أيّ منها إلى ظهور الخطأ 429 "تجاوزت الحصة". على سبيل المثال، إذا كان الحدّ الأقصى لعدد الطلبات في الدقيقة هو 20، سيؤدي إرسال 21 طلبًا خلال دقيقة إلى ظهور خطأ، حتى إذا لم تتجاوز الحدّ الأقصى لعدد الرموز المميّزة في الدقيقة أو الحدود الأخرى.
يتم تطبيق الحدود القصوى لمعدّل الاستخدام على مستوى المشروع، وتنطبق على جميع التطبيقات وعناوين IP التي تستخدم مشروع Firebase هذا.
تختلف الحدود حسب النموذج المحدّد المستخدَم، ولا تنطبق بعض الحدود إلا على نماذج معيّنة. على سبيل المثال، لا يتم احتساب الصور في الدقيقة (IPM) إلا للنماذج القادرة على إنشاء الصور (Imagen)، ولكنها تشبه من الناحية المفاهيمية الحدّ الأقصى لعدد الرموز المميّزة في الدقيقة.
تكون الحدود القصوى لمعدّل الاستخدام أكثر تقييدًا للنماذج التجريبية ونماذج المعاينة.
طلب زيادة الحدّ الأقصى لمعدّل الاستخدام
إذا كنت تستخدم "مستوى مدفوعًا" في Gemini Developer API، يمكنك طلب زيادة الحدّ الأقصى لمعدّل الاستخدام.
ضبط الحدود القصوى لمعدّل الاستخدام "لكل مستخدم"
لاستخدام Firebase AI Logic، يجب تفعيل مقدّم Gemini API الذي اخترته في مشروعك، ولكن يجب أيضًا تفعيل Firebase AI Logic API، الذي يعمل كبوابة بين حِزم تطوير البرامج (SDK) للعميل ومقدّم Gemini API. يتم تفعيل واجهة برمجة التطبيقات هذه لك عند إعداد Firebase AI Logic في مشروعك على Firebase لأول مرة.
يمكنك استخدام الحدّ الأقصى لمعدّل الاستخدام (الحصة) في Firebase AI Logic API كحدّ أقصى لمعدّل الاستخدام "لكل مستخدم" في تطبيقك، وتحديدًا لميزات الذكاء الاصطناعي التي تعتمد على Firebase AI Logic. يجب ضبط هذا الحدّ بشكل معقول لاستيعاب وصول مستخدم واحد إلى ميزات الذكاء الاصطناعي، مع ضمان عدم تجاوز أي مستخدم واحد لحدود مقدّم Gemini API (المخصّص لمشاركة جميع المستخدمين).
تفاصيل عن الحدّ الأقصى لمعدّل الاستخدام "لكل مستخدم"
في ما يلي بعض التفاصيل المهمة عن الحدود القصوى لمعدّل الاستخدام (الحصص) في Firebase AI Logic API ، وتحديدًا الطلبات في الدقيقة (RPM):
يستند هذا الحدّ إلى "طلبات إنشاء المحتوى" لكل مستخدم في كل منطقة في الدقيقة، ولا يستند إلى النموذج.
هذا هو الحدّ الأقصى لمعدّل الاستخدام الذي يتم تطبيقه على جميع المستخدمين. في الوقت الحالي، لا توجد طريقة لضبط الحدّ الأقصى لمعدّل الاستخدام لمستخدم معيّن أو مجموعة معيّنة من المستخدمين*.
يتم تطبيق هذا الحدّ على مستوى المشروع، وينطبق على جميع التطبيقات وعناوين IP التي تستخدم مشروع Firebase هذا.
ينطبق هذا الحدّ على أي طلب وارد تحديدًا من أي Firebase AI Logic حزمة تطوير برامج (SDK).
الحدّ الأقصى التلقائي لمعدّل الاستخدام هو 100 طلب في الدقيقة لكل مستخدم.
يُرجى العِلم أنّه لا يزال عليك مراعاة الحدود القصوى لمقدّم Gemini API (راجِع أعلاه)، التي لها الأولوية على Firebase AI Logic API.
* إذا كنت تستخدم Agent Platform Gemini API (formerly Vertex AI) وكان تطبيقك يوجّه المستخدمين إلى مناطق مختلفة (على سبيل المثال، باستخدام Firebase Remote Config)، يمكنك ضبط حدّ أقصى لمعدّل الاستخدام محدّد للمستخدمين في منطقة معيّنة.
تعديل الحدّ الأقصى لمعدّل الاستخدام "لكل مستخدم"
لتعديل حدّ أقصى لمعدّل الاستخدام (حصة)، يجب أن يكون لديك الإذن serviceusage.quotas.update ، الذي يتم تضمينه تلقائيًا في دورَي "المالك" و"المحرِّر".
إليك كيفية تعديل الحدّ الأقصى لمعدّل الاستخدام (الحصة) أو طلب زيادته:
في Google Cloud Console، انتقِل إلى صفحة Firebase AI Logic API.
انقر على إدارة.
في أسفل الصفحة، انقر على علامة التبويب الحصص وحدود النظام.
فلتر الجدول لعرض الحصص التي تهمّك، مثل الإمكانية (طلبات إنشاء المحتوى) والمنطقة.
على سبيل المثال، لعرض الحصص لكل مستخدم لطلبات إنشاء المحتوى في أي من المناطق الآسيوية المتوافقة، سيبدو الفلتر على النحو التالي:
Generate content requests+Dimension:region:asiaضَع علامة في المربّع على يمين كل حصة تهمّك.
في نهاية صفّ الحصة، انقر على , ثم على تعديل الحصة.
في نموذج تغييرات الحصة ، اتّبِع الخطوات التالية:
أدخِل الحصة المتزايدة في حقل القيمة الجديدة.
تنطبق هذه الحصة على مستوى المشروع، ويتم مشاركتها بين جميع التطبيقات وعناوين IP التي تستخدم مشروع Firebase هذا.
أكمِل أي حقول إضافية في النموذج، ثم انقر على تم.
انقر على إرسال الطلب.