تجاوز حصة Gemini API (429 RESOURCE_EXHAUSTED)
تعيد Gemini API الخطأ 429 RESOURCE_EXHAUSTED عندما تتجاوز حد الطلبات أو حصة يومية. في المستوى المجاني تكون الحدود صغيرة. تشرح هذه الصفحة كل صيغة من الخطأ، والحدود المجانية الحالية، والإصلاحات التي تنجح.
تُعرض الشيفرة وأسماء النماذج وتسميات الكتالوج المباشر باللغة الإنجليزية.
شكل الخطأ
يتكون خطأ نموذجي في المستوى المجاني، كما يُنشر في منتدى مطوري Google، من هذه الأجزاء:
مثال على الخطأ 429 من المستوى المجاني
429 RESOURCE_EXHAUSTED
You exceeded your current quota, please check your plan and billing details.
Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 50
quotaId: GenerateRequestsPerDayPerProjectPerModel-FreeTier
Please retry in 11.615098148s.quotaMetricيخبرك بما نفد. يحسبgenerate_content_free_tier_requestsالطلبات في المستوى المجاني.quotaIdيخبرك بالنافذة الزمنية.PerDayهي الحصة اليومية. والمعرّفPerMinuteهو حد الدقيقة.limitهو حصتك لذلك النموذج في تلك النافذة.Please retry inيعطي وقت الانتظار الذي تقترحه Google.
رموز 429 الثلاثة ورمز 403 واحد
تسرد صفحة أخطاء Google API ثلاثة رموز أخطاء بالحالة HTTP 429، ورمزًا مرتبطًا به بالحالة 403:
| الرمز | HTTP | المعنى | الحل |
|---|---|---|---|
rate_limit_exceeded | 429 | وصلت إلى حد الطلبات أو الرموز في الدقيقة أو في الثانية | أعد المحاولة مع تأخير متزايد أسيًا |
quota_exceeded | 429 | استُنفدت الحصة اليومية | انتظر إعادة الضبط، أو اطلب زيادة |
too_many_requests | 429 | طلبات كثيرة في نافذة زمنية قصيرة | أعد المحاولة مع تأخير متزايد أسيًا |
permission_denied | 403 | المشروع مقيّد، أو المستوى المجاني غير متاح له | اربط حسابًا للفوترة واستخدم المستوى المدفوع |
يزول حد الدقيقة في أقل من دقيقة. أما الحصة اليومية فتزول فقط عند إعادة الضبط. تعيد Google ضبط الطلبات اليومية عند منتصف الليل بتوقيت المحيط الهادئ. إعادة محاولة خطأ الحصة اليومية قبل إعادة الضبط تهدر الطلبات.
حدود المستوى المجاني اليوم
تطبق Google الحدود على كل مشروع في Google Cloud، لا على كل مفتاح. تختلف الحدود لكل نموذج. تعرض Google حدودك الفعالة في AI Studio. يعرض الجدول حدود Gemini وGemma المجانية في كتالوج FreeLLMAPI.
| النموذج | مجاني على | السياق | الحدود المجانية (أفضل عرض) | الأدوات | الرؤية |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | نعم | نعم |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| Gemini 3.8 Live | Google AI Studio | - | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | لا | لا |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | لا | لا |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | لا | نعم |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
يعرض 12 من أصل 21 نموذجًا مجانيًا مطابقًا. عرض كل النماذج.
بيانات مباشرة من كتالوج FreeLLMAPI (الإصدار 2026.11.19، تم التحقق 2026-11-19). تتغير الحدود المجانية كثيرًا. يُفحص الكتالوج كل يوم.
تسمح معظم نماذج Flash بنحو 20 طلبًا في اليوم في المستوى المجاني. تسمح نماذج Gemma بطلبات أكثر بكثير في اليوم، لكن نافذة سياقها أصغر. تقول Google إن الحدود المحددة غير مضمونة، وإن السعة الفعلية قد تتغير.
إصلاحات تنجح
- اقرأ
quotaId. إذا كان يحتوي علىPerDay، فتوقف وانتظر إعادة الضبط عند منتصف الليل بتوقيت المحيط الهادئ. - بالنسبة لحد الدقيقة، أعد المحاولة مع تأخير متزايد أسيًا وعشوائية (jitter). حدد عددًا أقصى لمحاولات إعادة المحاولة.
- انقل المهام البسيطة إلى نموذج له سقف يومي أعلى، مثل نموذج Gemma أو Flash-Lite.
- أرسل رموزًا أقل. تصل المطالبات الكبيرة إلى حد الرموز في الدقيقة بسرعة.
- لا تستخدم قيمة
max_tokensصغيرة جدًا. يمكن لـ Gemini Flash أن يستخدم رموز تفكير مخفية ضمن سقف المخرجات.
| ما تجربه | هل يساعد؟ | السبب |
|---|---|---|
| إنشاء مفتاح API جديد في المشروع نفسه | لا | الحدود تُطبق على المشروع. تقول Google إن المفتاح الجديد لا يحل الخطأ. |
| ترقية المشروع إلى المستوى المدفوع | يمنح حصة مدفوعة | تقول Google إن المستوى المدفوع لا يمنحك حصة المستوى المجاني. الاستخدام المدفوع يُحاسَب. |
انتظر وقت retry in | نعم، لحدود الدقيقة | تنتهي نافذة الدقيقة وتبدأ من جديد |
| التحويل إلى نموذج آخر | نعم | لكل نموذج حصته الخاصة |
تحقق من حصتك قبل الإرسال
يمكنك رؤية المشكلة قبل ظهور الخطأ. افتح في AI Studio صفحة حدود الطلبات من وثائق Gemini API. تعرض الحدود الفعالة لمشروعك لكل نموذج. تعرض صفحة Projects مستواك.
إذا كنت تستخدم FreeLLMAPI، فاسأل البوابة عن النماذج الجاهزة الآن. يملك النموذج ذو الحالة exhausted مفاتيح كلها في فترة تهدئة. تزول هذه الحالة تلقائيًا عند انتهاء فترات التهدئة.
سرد النماذج التي يمكنها الرد الآن
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"خطط لاستخدامك اليومي بأرقام بسيطة. عند 20 طلبًا في اليوم، يمنحك نموذج Flash واحد طلبًا تقريبًا كل 72 دقيقة طوال اليوم. قد يستخدم وكيل البرمجة 20 طلبًا لمهمة واحدة. استخدم نماذج Flash للمهام الصعبة فقط، وأرسل المهام البسيطة إلى نماذج لها سقوف يومية أكبر.
التحويل الاحتياطي إلى مزوّدين مجانيين آخرين
مع نحو 20 طلب Flash في اليوم، لا يكفي مفتاح Gemini واحد لعمل الوكيل. يضع FreeLLMAPI Gemini خلف نقطة وصول واحدة مع مزوّدين مجانيين آخرين. عندما يرسل Gemini الخطأ 429، يرسل الموجّه الطلب إلى النموذج التالي في سلسلتك.
- يحسب الموجّه RPM وRPD وTPM وTPD لكل نموذج ومفتاح. يتوقف قبل أن يصل إلى حد معروف.
- يضع الخطأ 429 القصير المفتاح في فترة تهدئة مدتها 90 ثانية. أما الحصة اليومية المستنفدة فتستخدم فترة تهدئة أطول: دقيقتين، ثم 10 دقائق، ثم ساعة، ثم 24 ساعة.
- إذا أعطت Google وقت إعادة محاولة أطول، يستخدم الموجّه قيمة Google.
- تسرد ترويسة
X-Fallback-Trailكل قفزة فاشلة، مثلgoogle/gemini-2.5-flash key1=rate_limited.
أرسل حركة Gemini عبر البوابة
curl -fsSL https://freellmapi.co/install.sh | bash
curl -i http://localhost:3001/v1/chat/completions \
-H "Authorization: Bearer <unified-key>" \
-H "Content-Type: application/json" \
-d '{"model": "auto", "messages": [{"role": "user", "content": "hi"}]}'يستطيع Gemini CLI أيضًا استخدام واجهة /v1beta الأصلية للبوابة. لا تضيف البوابة حصة Gemini. بل تستخدم مزوّدين آخرين عندما يصل Gemini إلى حده.
تفردات Gemini المعروفة
| المزوّد | مشكلة معروفة | ما الذي يجب فعله |
|---|---|---|
| Google AI Studio | Thinking tokens use output cap | Gemini Flash can spend hidden thinking tokens inside maxOutputTokens. Avoid tiny max_tokens values or set thinkingBudget to 0 when provider support is available. |
بيانات مباشرة من كتالوج FreeLLMAPI (الإصدار 2026.11.19، تم التحقق 2026-11-19). تتغير الحدود المجانية كثيرًا. يُفحص الكتالوج كل يوم.
الأسئلة الشائعة
ماذا يعني 429 RESOURCE_EXHAUSTED في Gemini API؟
يعني أن مشروعك تجاوز حد الطلبات أو حصة. يخبرك quotaId في نص الخطأ إن كان حد دقيقة أم حصة يومية.
متى تعاد ضبط حصة المستوى المجاني لـ Gemini؟
تُعاد ضبط الطلبات اليومية عند منتصف الليل بتوقيت المحيط الهادئ. وتعاد ضبط حدود الدقيقة خلال دقيقة واحدة.
لماذا لا يحل مفتاح Gemini API جديد خطأ الحصة؟
تطبق Google الحدود على مشروع Google Cloud، لا على المفتاح. كل مفتاح في المشروع نفسه يشترك في الحصة نفسها.
ماذا يعني limit: 0 في خطأ حصة Gemini؟
يعني أن مشروعك لا يملك حصة مجانية لذلك النموذج في تلك النافذة. بعض المشاريع غير مؤهلة للمستوى المجاني. تحقق من حدودك في AI Studio، أو جرّب نموذجًا آخر.
كيف أتجنب أخطاء Gemini 429 في وكيل برمجة؟
استخدم عدة مزوّدين مجانيين خلف بوابة واحدة. عندما يصل Gemini إلى حده، ترسل البوابة الطلب إلى مزوّد آخر، فيستمر الوكيل في العمل.
أدلة ذات صلة
- حدود معدل واجهات LLM المجانية
- free gemini api
- Gemini CLI مع نقطة وصول مخصصة ونماذج مجانية
- بلوغ حد معدل Groq (429)
- حد معدل NVIDIA NIM API
المصادر
- Google AI Studio: Rate limits (تم التحقق 20 November 2026)
- Google AI Studio: API errors (تم التحقق 20 November 2026)
- Google AI Studio: Troubleshooting (تم التحقق 20 November 2026)
- Google developer forum: free tier quota error example (تم التحقق 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (تم التحقق 20 November 2026)
- FreeLLMAPI docs: Response headers (تم التحقق 20 November 2026)