تتحكّم حدود وتيرة الطلبات في عدد الطلبات التي يمكنك إرسالها إلى Gemini API خلال إطار زمني محدّد. تساعد هذه الحدود في الحفاظ على الاستخدام العادل والحماية من إساءة الاستخدام والحفاظ على أداء النظام لجميع المستخدمين.
الاطّلاع على حدود المعدّل النشطة في AI Studio
طريقة عمل حدود المعدّل
عادةً ما يتم قياس حدود المعدّل على مستوى ثلاثة جوانب:
- الطلبات في الدقيقة (RPM)
- الرموز المميزة في الدقيقة (الإدخال) (TPM)
- الطلبات في اليوم (RPD)
يتم تقييم استخدامك مقارنةً بكل حد، وسيؤدي تجاوز أي منها إلى ظهور خطأ الحد الأقصى للمعدل. على سبيل المثال، إذا كان الحد الأقصى لعدد الطلبات في الدقيقة هو 20، سيؤدي تقديم 21 طلبًا خلال دقيقة واحدة إلى حدوث خطأ، حتى إذا لم تتجاوز الحد الأقصى لعدد الطلبات في الدقيقة أو الحدود الأخرى.
يتم تطبيق حدود المعدّل لكل مشروع، وليس لكل مفتاح واجهة برمجة التطبيقات. تتم إعادة ضبط حصص الطلبات في اليوم (RPD) في منتصف الليل بتوقيت المحيط الهادئ.
تختلف الحدود القصوى حسب النموذج المحدّد المستخدَم، ولا تنطبق بعض الحدود إلا على نماذج معيّنة. على سبيل المثال، يتم احتساب عدد الصور في الدقيقة (IPM) فقط للنماذج القادرة على إنشاء الصور (Nano Banana)، ولكنها تشبه من الناحية النظرية عدد الرموز المميزة في الدقيقة (TPM). قد تفرض النماذج الأخرى حدًا أقصى لعدد الرموز المميزة في اليوم (TPD).
تكون حدود الاستخدام أكثر تقييدًا للنماذج التجريبية ونماذج المعاينة.
حدود معدّل الاستخدام المستندة إلى الإنفاق
بالإضافة إلى حدود الطلبات في الدقيقة (RPM) والرموز المميزة في الدقيقة (TPM)، تفرض Gemini API حدودًا على المعدّل استنادًا إلى الإنفاق للحماية من الرسوم غير المتوقّعة. يعتمد تطبيق هذه الحدود على حسابك على سجلّ الفواتير وفئة الاستخدام.
يعرض الجدول التالي حدود المعدّل المستندة إلى الإنفاق لكل فئة استخدام. يتم تقييم هذه الحدود على مدار فترة 10 دقائق متواصلة. يعتمد ما إذا كانت هذه الحدود تنطبق على حسابك على سجلّ الفوترة وحالة الحساب.
| فئة الاستخدام | الحدّ الأقصى لمعدّل الإنفاق (كل 10 دقائق) |
|---|---|
| Free | لا ينطبق |
| المستوى 1 | $10 |
| المستوى 2 | دولار هونغ كونغ |
| المستوى 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 لحدود معدّل خاصة بها، وهي منفصلة عن طلبات البيانات من واجهة برمجة التطبيقات غير المجمّعة.
- طلبات الدفعات المتزامنة: 100
- الحد الأقصى لحجم ملف الإدخال: 2 غيغابايت
- الحد الأقصى لمساحة تخزين الملفات: 20 غيغابايت
- الرموز المميزة التي تمّت إضافتها إلى قائمة الانتظار لكل نموذج: يسرد جدول الرموز المميزة التي تمّت إضافتها إلى قائمة الانتظار في الدُفعات الحد الأقصى لعدد الرموز المميزة التي يمكن إضافتها إلى قائمة الانتظار للمعالجة على دفعات في جميع مهام المعالجة المجمّعة النشطة لنموذج معيّن.
صف 1
| الطراز | الرموز المميّزة التي تمت إضافتها إلى قائمة الانتظار بشكل مجمّع | |||
|---|---|---|---|---|
| نماذج تحويل النص إلى صوت | ||||
| معاينة 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 🍌 | 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.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 | 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.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 | 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 للاطّلاع على مستوياتك.
طلب زيادة الحدّ الأقصى لمعدّل الطلبات
يتضمّن كل نوع من النماذج حدًا أقصى لعدد الطلبات (الطلبات في الدقيقة). للحصول على تفاصيل حول حدود المعدّل هذه، يُرجى الاطّلاع على صفحة حدود المعدّل في AI Studio.
طلب زيادة الحدّ الأقصى لمعدّل الطلبات في الفئة المدفوعة
لا نقدّم أي ضمانات بشأن زيادة الحدّ الأقصى لعدد الطلبات، ولكن سنبذل قصارى جهدنا لمراجعة طلبك.