تحدّد سقوف الاستخدام عدد الطلبات التي يمكنك إرسالها إلى 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 Preview | 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 | |||
| Gemini 2.0 Flash Image | 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 Embedding | 500,000 | |||
صف 2
| الطراز | الرموز المميّزة التي تمت إضافتها إلى قائمة الانتظار بشكل مجمّع | |||
|---|---|---|---|---|
| نماذج تحويل النص إلى صوت | ||||
| Gemini 4 Argon | 500,000,000 | |||
| النسخة الحصرية من 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 | |||
| Gemini 2.0 Flash Image | 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 | 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 | 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 | 10,000,000 | |||
كيفية الترقية إلى المستوى التالي
للانتقال من المستوى المجاني إلى مستوى مدفوع، عليك أولاً إعداد الفوترة في AI Studio.
بعد استيفاء مشروعك المعايير المحدّدة، سيتم تلقائيًا ترقيته إلى الفئة التالية. عادةً ما يتم تطبيق ترقيات المستوى من المستوى المجاني إلى المستوى 1 على الفور، وسيتم تطبيق ترقيات المستوى اللاحقة في غضون 10 دقائق. انتقِل إلى صفحة "المشاريع" في AI Studio للاطّلاع على مستوياتك.
طلب زيادة الحدّ الأقصى لمعدّل الطلبات
يتضمّن كل نوع من النماذج حدًا أقصى لعدد الطلبات (الطلبات في الدقيقة). لمعرفة التفاصيل حول هذه الحدود، يُرجى الاطّلاع على صفحة حدود معدّل الاستخدام في AI Studio.
طلب زيادة الحدّ الأقصى لمعدّل الطلبات في الفئة المدفوعة
لا نقدّم أي ضمانات بشأن زيادة الحدّ الأقصى لمعدّل الطلبات، ولكننا سنبذل قصارى جهدنا لمراجعة طلبك.