تتحكّم حدود معدّل الطلبات في عدد الطلبات التي يمكنك إرسالها إلى Gemini API خلال إطار زمني محدّد. تساعد هذه الحدود في الحفاظ على الاستخدام العادل والحماية من إساءة الاستخدام والحفاظ على أداء النظام لجميع المستخدمين.
الاطّلاع على حدود المعدّل النشطة في AI Studio
طريقة عمل حدود المعدّل
يتم عادةً قياس حدود المعدّل على مستوى ثلاثة جوانب:
- الطلبات في الدقيقة (RPM)
- الرموز المميزة في الدقيقة (الإدخال) (TPM)
- الطلبات في اليوم (RPD)
يتم تقييم استخدامك مقارنةً بكل حد، وسيؤدي تجاوز أي منها إلى ظهور خطأ في الحد الأقصى لمعدّل الطلبات. على سبيل المثال، إذا كان الحدّ الأقصى لعدد الطلبات في الدقيقة هو 20، سيؤدي تقديم 21 طلبًا خلال دقيقة واحدة إلى حدوث خطأ، حتى إذا لم تتجاوز الحدّ الأقصى لعدد الطلبات في الدقيقة أو الحدود الأخرى.
يتم تطبيق حدود المعدّل لكل مشروع، وليس لكل مفتاح API. تتم إعادة ضبط حصص الطلبات في اليوم (RPD) في منتصف الليل بتوقيت المحيط الهادئ.
تختلف الحدود القصوى حسب النموذج المحدّد المستخدَم، ولا تنطبق بعض الحدود إلا على نماذج محدّدة. على سبيل المثال، يتم احتساب "الصور في الدقيقة" (IPM) فقط للنماذج القادرة على إنشاء الصور (Nano Banana)، ولكنها تتشابه من الناحية النظرية مع "الرموز المميزة في الدقيقة" (TPM). قد تفرض النماذج الأخرى حدًا أقصى لعدد الرموز المميزة في اليوم (TPD).
تكون حدود الاستخدام أكثر تقييدًا للنماذج التجريبية ونماذج المعاينة.
حدود الاستخدام المستندة إلى الإنفاق
بالإضافة إلى حدود الطلبات في الدقيقة والرموز المميزة في الدقيقة، تفرض واجهة Gemini API حدودًا على المعدّل استنادًا إلى الإنفاق للحماية من الرسوم غير المتوقّعة. يعتمد ما إذا كانت هذه الحدود تنطبق على حسابك على سجلّ الفواتير وفئة الاستخدام.
يعرض الجدول التالي حدود المعدّل المستندة إلى الإنفاق لكل فئة استخدام. يتم تقييم هذه الحدود على مدار فترة 10 دقائق متواصلة. يعتمد ما إذا كانت هذه الحدود تنطبق على حسابك على سجلّ الفوترة وحالة الحساب.
| فئة الاستخدام | الحدّ الأقصى لمعدّل الإنفاق (كل 10 دقائق) |
|---|---|
| Free | لا ينطبق |
| المستوى 1 | $10 |
| المستوى 2 | $200 |
| المستوى 3 | $200 |
إذا تجاوزت الحدّ الأقصى لمعدّل الاستخدام المستند إلى الإنفاق، ستعرض واجهة برمجة التطبيقات رسالة 429 RESOURCE_EXHAUSTEDخطأ. لحلّ هذه المشكلة، اتّبِع الخطوات التالية:
- الانتظار وإعادة المحاولة بعد فترة قصيرة
- تقليل معدّل الطلبات المكلفة، مثلاً من خلال استخدام نوافذ سياق أصغر أو نواتج أقصر
- إذا كنت تصل إلى هذا الحدّ باستمرار أثناء الاستخدام العادي، يمكنك طلب زيادة الحدّ الأقصى للمعدّل.
فئات الاستخدام
ترتبط حدود المعدّل بفئة استخدام المشروع. مع زيادة استخدامك لواجهة برمجة التطبيقات وإنفاقك، ستتم ترقيتك تلقائيًا إلى فئة أعلى مع زيادة في حدود وتيرة الطلبات.
تستند مؤهلات الفئتين 2 و3 إلى إجمالي الإنفاق التراكمي على خدمات Google Cloud (بما في ذلك، على سبيل المثال لا الحصر، Gemini API) لحساب الفوترة المرتبط بمشروعك.
| فئة الاستخدام | التصفيات | الحد الأقصى لفئة الفوترة |
|---|---|---|
| Free | مشروع نشط أو فترة تجريبية مجانية | لا ينطبق |
| المستوى 1 | إعداد حساب فوترة نشط وربطه | 250 دولار أمريكي |
| المستوى 2 | تم دفع 100 دولار أمريكي + 3 أيام من أول عملية دفع ناجحة | 2000 دولار أمريكي (أو ما يعادله بالعملة المحلية) |
| المستوى 3 | تم دفع 1,000 دولار أمريكي + 30 يومًا من أول عملية دفع ناجحة | 20,000 دولار أمريكي - 100,000 دولار أمريكي أو أكثر |
على الرغم من أنّ استيفاء معايير الأهلية المذكورة يكون بشكل عام كافيًا للحصول على الموافقة، قد يتم رفض طلب الترقية في حالات نادرة استنادًا إلى عوامل أخرى يتم تحديدها أثناء عملية المراجعة.
يساعد هذا النظام في الحفاظ على أمان منصة Gemini API وسلامتها لجميع المستخدمين.
الحدود القصوى لعدد الطلبات في الدقيقة في Gemini API
تعتمد حدود المعدّل على مجموعة متنوّعة من العوامل (مثل مستوى الاستخدام)، ويمكن الاطّلاع عليها في Google AI Studio. مع تغيُّر مستوى حسابك وحالته بمرور الوقت، سيتم تعديل حدود المعدّل تلقائيًا.
الاطّلاع على حدود المعدّل النشطة في AI Studio
لا يمكن ضمان حدود المعدّل المحدّدة، وقد تختلف السعة الفعلية.
الحدود القصوى لمعدّل الاستنتاج حسب الأولوية
تخضع عمليات الاستهلاك ذات الأولوية لحدود معدّل خاصة بها، على الرغم من أنّ عمليات الاستهلاك تُحتسب ضمن حدود معدّل الزيارات التفاعلية الإجمالية. حدود المعدّل التلقائية هي: 0.3 مرة حد المعدّل العادي لكل نموذج ومستوى
الحدود القصوى المسموح بها لمعدل الزيارات في واجهة Batch API
تخضع طلبات Batch API لحدود معدّل خاصة بها، وهي منفصلة عن طلبات API غير المجمّعة.
- طلبات الدفعات المتزامنة: 100
- الحد الأقصى لحجم ملف الإدخال: 2 غيغابايت
- الحد الأقصى لمساحة تخزين الملفات: 20 غيغابايت
- الرموز المميزة التي تمت إضافتها إلى قائمة الانتظار لكل نموذج: يسرد جدول الرموز المميزة المضافة إلى قائمة الانتظار للمعالجة على دفعات الحد الأقصى لعدد الرموز المميزة التي يمكن إضافتها إلى قائمة الانتظار للمعالجة على دفعات في جميع مهام المعالجة المجمّعة النشطة لنموذج معيّن.
صف 1
| الطراز | الرموز المميّزة التي تمت إضافتها إلى قائمة الانتظار بشكل مجمّع | |||
|---|---|---|---|---|
| نماذج تحويل النص إلى صوت | ||||
| معاينة Gemini 3.1 Pro | 5,000,000 | |||
| Gemini 3.1 Flash-Lite | 10,000,000 | |||
| معاينة Gemini 3.1 Flash-Lite | 10,000,000 | |||
| Gemini 3.5 Flash | 3,000,000 | |||
| Gemini 3.5 Flash | 3,000,000 | |||
| Gemini 2.5 Pro | 5,000,000 | |||
| Gemini 2.5 Pro TTS | 25,000 | |||
| Gemini 2.5 Flash | 3,000,000 | |||
| معاينة Gemini 2.5 Flash | 3,000,000 | |||
| معاينة Gemini 2.5 Flash Image | 3,000,000 | |||
| Gemini 2.5 Flash TTS | 100,000 | |||
| Gemini 2.5 Flash-Lite | 10,000,000 | |||
| Gemini 2.5 Flash-Lite (نسخة حصرية) | 10,000,000 | |||
| Gemini 2.0 Flash | 10,000,000 | |||
| صورة Gemini 2.0 Flash | 3,000,000 | |||
| Gemini 2.0 Flash-Lite | 10,000,000 | |||
| نماذج الإنشاء المتعددة الوسائط | ||||
| معاينة Gemini 3.1 Flash Image 🍌 | 1,000,000 | |||
| معاينة صورة Gemini 3 Pro 🍌 | 2,000,000 | |||
| نماذج التضمين | ||||
| تضمين Gemini | 500,000 | |||
صف 2
| الطراز | الرموز المميّزة التي تمت إضافتها إلى قائمة الانتظار بشكل مجمّع | |||
|---|---|---|---|---|
| نماذج تحويل النص إلى صوت | ||||
| معاينة Gemini 3.1 Pro | 500,000,000 | |||
| Gemini 3.1 Flash-Lite | 500,000,000 | |||
| معاينة Gemini 3.1 Flash-Lite | 500,000,000 | |||
| Gemini 3.5 Flash | 400,000,000 | |||
| Gemini 3.5 Flash | 400,000,000 | |||
| Gemini 2.5 Pro | 500,000,000 | |||
| Gemini 2.5 Pro TTS | 100,000 | |||
| Gemini 2.5 Flash | 400,000,000 | |||
| معاينة Gemini 2.5 Flash | 400,000,000 | |||
| معاينة Gemini 2.5 Flash Image | 400,000,000 | |||
| Gemini 2.5 Flash TTS | 100,000 | |||
| Gemini 2.5 Flash-Lite | 500,000,000 | |||
| Gemini 2.5 Flash-Lite (نسخة حصرية) | 500,000,000 | |||
| Gemini 2.0 Flash | 1,000,000,000 | |||
| صورة Gemini 2.0 Flash | 400,000,000 | |||
| Gemini 2.0 Flash-Lite | 1,000,000,000 | |||
| نماذج الإنشاء المتعددة الوسائط | ||||
| معاينة Gemini 3.1 Flash Image 🍌 | 250,000,000 | |||
| معاينة صورة Gemini 3 Pro 🍌 | 270,000,000 | |||
| نماذج التضمين | ||||
| تضمين Gemini | 5,000,000 | |||
مستوى ثالث
| الطراز | الرموز المميّزة التي تمت إضافتها إلى قائمة الانتظار بشكل مجمّع | |||
|---|---|---|---|---|
| نماذج تحويل النص إلى صوت | ||||
| معاينة Gemini 3.1 Pro | 1,000,000,000 | |||
| Gemini 3.1 Flash-Lite | 1,000,000,000 | |||
| معاينة Gemini 3.1 Flash-Lite | 1,000,000,000 | |||
| Gemini 3.5 Flash | 1,000,000,000 | |||
| Gemini 3.5 Flash | 1,000,000,000 | |||
| Gemini 2.5 Pro | 1,000,000,000 | |||
| Gemini 2.5 Pro TTS | 1,000,000 | |||
| Gemini 2.5 Flash | 1,000,000,000 | |||
| معاينة Gemini 2.5 Flash | 1,000,000,000 | |||
| معاينة Gemini 2.5 Flash Image | 1,000,000,000 | |||
| Gemini 2.5 Flash TTS | 4,000,000 | |||
| Gemini 2.5 Flash-Lite | 1,000,000,000 | |||
| Gemini 2.5 Flash-Lite (نسخة حصرية) | 1,000,000,000 | |||
| Gemini 2.0 Flash | 5,000,000,000 | |||
| صورة Gemini 2.0 Flash | 1,000,000,000 | |||
| Gemini 2.0 Flash-Lite | 5,000,000,000 | |||
| نماذج الإنشاء المتعددة الوسائط | ||||
| معاينة Gemini 3.1 Flash Image 🍌 | 750,000,000 | |||
| معاينة صورة Gemini 3 Pro 🍌 | 1,000,000,000 | |||
| نماذج التضمين | ||||
| تضمين Gemini | 10,000,000 | |||
كيفية الترقية إلى المستوى التالي
للانتقال من المستوى المجاني إلى مستوى مدفوع، عليك أولاً إعداد الفوترة في AI Studio.
بعد أن يستوفي مشروعك المعايير المحدّدة، ستتم ترقيته تلقائيًا إلى المستوى التالي. عادةً ما يتم تطبيق ترقيات المستوى من المستوى المجاني إلى المستوى 1 على الفور، وسيتم تطبيق ترقيات المستوى اللاحقة في غضون 10 دقائق. انتقِل إلى صفحة "المشاريع" في AI Studio للاطّلاع على مستوياتك.
طلب زيادة الحدّ الأقصى لمعدّل الطلبات
يتضمّن كل نوع من النماذج حدًا أقصى لعدد الطلبات (طلبات في الدقيقة، RPM). للحصول على تفاصيل حول حدود المعدّل هذه، يُرجى الاطّلاع على صفحة حدود المعدّل في AI Studio.
طلب زيادة حدّ معدّل الطلبات في المستوى المدفوع
لا يمكننا تقديم أي ضمانات بشأن زيادة الحدّ الأقصى لعدد الطلبات، ولكننا سنبذل قصارى جهدنا لمراجعة طلبك.