|
انقر على مقدّم 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.
* إذا كنت تستخدم Vertex AI Gemini API وكان تطبيقك يوجّه المستخدمين إلى مناطق مختلفة (على سبيل المثال، باستخدام Firebase Remote Config)، يمكنك ضبط حدّ أقصى لمعدّل الاستخدام محدّد للمستخدمين في منطقة معيّنة.
تعديل الحدّ الأقصى لمعدّل الاستخدام "لكل مستخدم"
لتعديل الحدّ الأقصى لمعدّل الاستخدام (الحصة)، يجب أن يكون لديك الإذن serviceusage.quotas.update ، الذي يتم تضمينه تلقائيًا في دورَي "المالك" و"المحرِّر".
إليك كيفية تعديل الحدّ الأقصى لمعدّل الاستخدام (الحصة) أو طلب زيادته:
في Google Cloud Console، انتقِل إلى صفحة Firebase AI Logic API.
انقر على إدارة.
في أسفل الصفحة، انقر على علامة التبويب الحصص وحدود النظام.
فلتر الجدول لعرض الحصص التي تهمّك، مثل الإمكانية (طلبات إنشاء المحتوى) والمنطقة.
على سبيل المثال، لعرض الحصص لكل مستخدم لطلبات إنشاء المحتوى في أي من المناطق الآسيوية المتوافقة، سيبدو الفلتر على النحو التالي:
Generate content requests+Dimension:region:asiaضَع علامة في مربّع الاختيار على يمين كل حصة تهمّك.
في نهاية صفّ الحصة، انقر على , ثم اختَر تعديل الحصة.
في نموذج تغييرات الحصة ، اتّبِع الخطوات التالية:
أدخِل الحصة المتزايدة في حقل القيمة الجديدة.
تنطبق هذه الحصة على مستوى المشروع، ويتم مشاركتها بين جميع التطبيقات وعناوين IP التي تستخدم مشروع Firebase هذا.
أكمِل أي حقول إضافية في النموذج، ثم انقر على تم.
انقر على إرسال الطلب.