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