الرئيسية / الأدلة / تجاوز حصة Gemini API (429 RESOURCE_EXHAUSTED)

تجاوز حصة 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:

من صفحة أخطاء Gemini API
الرمزHTTPالمعنىالحل
rate_limit_exceeded429وصلت إلى حد الطلبات أو الرموز في الدقيقة أو في الثانيةأعد المحاولة مع تأخير متزايد أسيًا
quota_exceeded429استُنفدت الحصة اليوميةانتظر إعادة الضبط، أو اطلب زيادة
too_many_requests429طلبات كثيرة في نافذة زمنية قصيرةأعد المحاولة مع تأخير متزايد أسيًا
permission_denied403المشروع مقيّد، أو المستوى المجاني غير متاح لهاربط حسابًا للفوترة واستخدم المستوى المدفوع

يزول حد الدقيقة في أقل من دقيقة. أما الحصة اليومية فتزول فقط عند إعادة الضبط. تعيد Google ضبط الطلبات اليومية عند منتصف الليل بتوقيت المحيط الهادئ. إعادة محاولة خطأ الحصة اليومية قبل إعادة الضبط تهدر الطلبات.

حدود المستوى المجاني اليوم

تطبق Google الحدود على كل مشروع في Google Cloud، لا على كل مفتاح. تختلف الحدود لكل نموذج. تعرض Google حدودك الفعالة في AI Studio. يعرض الجدول حدود Gemini وGemma المجانية في كتالوج FreeLLMAPI.

حدود Gemini وGemma المجانية من الكتالوج اليوم
النموذجمجاني علىالسياقالحدود المجانية (أفضل عرض)الأدواتالرؤية
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaنعمنعم
Gemini Flash (latest alias)Google AI Studio-10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
Gemini 3.7 FlashGoogle AI Studio1M10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
Gemini 3.6 FlashGoogle AI Studio1M10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
Gemini 3.5 FlashGoogle AI Studio1M10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
Gemini 3.8 LiveGoogle AI Studio-10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
Gemini 3.8 Flash TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyلالا
Gemini 3.8 Flash-Lite TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyلالا
Gemini Robotics-ER 2 PreviewGoogle AI Studio131K10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
لانعم
Gemini 3.5 Flash LiteGoogle AI Studio1M15 طلب/دقيقة
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 إن الحدود المحددة غير مضمونة، وإن السعة الفعلية قد تتغير.

إصلاحات تنجح

  1. اقرأ quotaId. إذا كان يحتوي على PerDay، فتوقف وانتظر إعادة الضبط عند منتصف الليل بتوقيت المحيط الهادئ.
  2. بالنسبة لحد الدقيقة، أعد المحاولة مع تأخير متزايد أسيًا وعشوائية (jitter). حدد عددًا أقصى لمحاولات إعادة المحاولة.
  3. انقل المهام البسيطة إلى نموذج له سقف يومي أعلى، مثل نموذج Gemma أو Flash-Lite.
  4. أرسل رموزًا أقل. تصل المطالبات الكبيرة إلى حد الرموز في الدقيقة بسرعة.
  5. لا تستخدم قيمة 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 StudioThinking tokens use output capGemini 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). تتغير الحدود المجانية كثيرًا. يُفحص الكتالوج كل يوم.

استخدم كل واحد من هذه النماذج عبر مفتاح واحد. FreeLLMAPI موجّه مفتوح المصدر تستضيفه بنفسك. يضع كل هذه المستويات المجانية خلف نقطة وصول واحدة متوافقة مع OpenAI، ويتحول تلقائيًا إلى مزوّد آخر عند تجاوز حد الطلبات. تصفح الكتالوج أو ابدأ الآن.

الأسئلة الشائعة

ماذا يعني 429 RESOURCE_EXHAUSTED في Gemini API؟

يعني أن مشروعك تجاوز حد الطلبات أو حصة. يخبرك quotaId في نص الخطأ إن كان حد دقيقة أم حصة يومية.

متى تعاد ضبط حصة المستوى المجاني لـ Gemini؟

تُعاد ضبط الطلبات اليومية عند منتصف الليل بتوقيت المحيط الهادئ. وتعاد ضبط حدود الدقيقة خلال دقيقة واحدة.

لماذا لا يحل مفتاح Gemini API جديد خطأ الحصة؟

تطبق Google الحدود على مشروع Google Cloud، لا على المفتاح. كل مفتاح في المشروع نفسه يشترك في الحصة نفسها.

ماذا يعني limit: 0 في خطأ حصة Gemini؟

يعني أن مشروعك لا يملك حصة مجانية لذلك النموذج في تلك النافذة. بعض المشاريع غير مؤهلة للمستوى المجاني. تحقق من حدودك في AI Studio، أو جرّب نموذجًا آخر.

كيف أتجنب أخطاء Gemini 429 في وكيل برمجة؟

استخدم عدة مزوّدين مجانيين خلف بوابة واحدة. عندما يصل Gemini إلى حده، ترسل البوابة الطلب إلى مزوّد آخر، فيستمر الوكيل في العمل.

أدلة ذات صلة

المصادر

كل الأدلة · تصفح كل النماذج المجانية