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