ربط Google AI Studio مع n8n: مشكلة Rate Limit التي توقف Gemini عن العمل بالكامل
ربط Google AI Studio مع n8n هو ما يحتاجه كل صانع محتوى يبني أتمتة لتوليد السكربتات من التريندات — لكن كثيرين يفاجَؤون بأن جميع العناصر تخرج من مخرج الخطأ (Error Output) بدون أي سبب واضح. في هذا الدليل الكامل نوضح السبب الحقيقي للمشكلة، وهو تجاوز حد الطلبات (Rate Limit) في الحساب المجاني من Google AI Studio، ونشرح خطوة بخطوة كيفية حلها بالكامل.
📌 وصف المشكلة
الووركفلو في n8n مصمم لسحب التريندات من Google Trends RSS، تقسيمها إلى عشرة عناصر، الانتظار لثوانٍ معدودة، ثم إرسال كل عنصر إلى نود Gemini لتوليد سكربت، وبعدها إلى ElevenLabs لتحويل النص إلى صوت، وأخيراً تحديث قاعدة بيانات Supabase.
المشكلة: عند تنفيذ الووركفلو، جميع العشرة عناصر تخرج من مخرج الخطأ (Error Output) في نود Gemini برسالة:
“The service is receiving too many requests from you”
وبالتالي لا يتم توليد حقل النص (text)، فيفشل نود ElevenLabs لأنه يستقبل نصاً فارغاً.
🛠️ المحاولات التي لم تنجح
- تجديد مفتاح Google AI Studio API المجاني — حل مشكلة “API key expired” لكن لم يحل مشكلة Rate Limit.
- تغيير إعداد On Error إلى “Stop Workflow” — أدى إلى توقف الووركفلو بالكامل دون أي مخرجات (No output data).
- استبدال النود القديم بنود Google Gemini الرسمي والجديد — نفس مشكلة “too many requests” استمرت.
✅ الحل: ربط Google AI Studio مع n8n بطريقة صحيحة
السبب الجذري هو أن الحساب المجاني من Google AI Studio (Gemini API) له حد صارم لعدد الطلبات في الدقيقة (RPM)، والووركفلو كان يرسل عشرة طلبات متتالية دفعة واحدة تقريباً، وهذا يتجاوز الحد فوراً.
الحل المتكامل لـ ربط Google AI Studio مع n8n يتكون من أربع خطوات:
- Loop Over Items (Split in Batches) بـ batch size = 1، بحيث يُرسل عنصر واحد فقط لكل طلب. (تنبيه: إذا كنت تستخدم Loop Over Items لأول مرة، راجع دليل حل مشكلة Infinite Loop في n8n لتجنب أي حلقة لا تنتهي.)
- Wait Node بين 10 و15 ثانية بين كل طلب وآخر، لتبقى تحت حد RPM المجاني.
- تفعيل Retry On Fail في إعدادات نود Gemini: Max Tries = 4، Wait Between Tries = 20000 مللي ثانية (20 ثانية).
- الإبقاء على On Error: Continue (using error output) بدلاً من Stop Workflow، لتسجيل أي عناصر فاشلة دون إيقاف الووركفلو بالكامل.
بعد تطبيق هذه التعديلات على ربط Google AI Studio مع n8n، كل العناصر العشرة تصل بنجاح إلى مخرج Success، ويُملأ حقل النص (text) بشكل صحيح، وينتقل بسلاسة إلى ElevenLabs لتوليد الصوت، ثم إلى Supabase لتحديث البيانات. هذه الطريقة في ربط Google AI Studio مع n8n مناسبة لأي عدد من العناصر، وليست محدودة بعشرة فقط — يمكن تطبيقها على مئات العناصر بنفس الكفاءة.
🎥 شاهد الشرح الكامل بالفيديو
في الفيديو التالي نوضح المشكلة على الهواء، نفتح نود Gemini ونعرض رسالة الخطأ الفعلية، ثم نطبق الحل الكامل خطوة بخطوة ونشغل الووركفلو لنرى النتيجة بأنفسنا.
❓ أسئلة شائعة حول ربط Google AI Studio مع n8n
ما سبب رسالة “too many requests” في Gemini؟
هذه الرسالة تعني أنك تجاوزت حد الطلبات المسموح بها في الدقيقة (RPM) للحساب المجاني من Google AI Studio، وهو حد منخفض جداً مقارنة بعدد الطلبات السريعة المتتالية.
هل تفعيل Retry On Fail كافٍ لحل المشكلة بمفرده؟
لا، يجب الجمع بين Retry On Fail و Loop Over Items مع Wait Node لضمان توزيع الطلبات بشكل صحيح تحت الحد المسموح.
ما الفرق بين On Error: Continue و Stop Workflow؟
خيار Continue يسمح للووركفلو بمعالجة باقي العناصر حتى لو فشل عنصر واحد، أما Stop Workflow فيوقف التنفيذ بالكامل عند أول خطأ، مما يمنع ظهور أي مخرجات.
هل يمكن استخدام مفتاح API مجاني في الإنتاج؟
نعم لأحجام صغيرة، لكن للمشاريع التي تعالج عدداً كبيراً من العناصر بشكل يومي، يُفضّل ترقية الحساب إلى خطة مدفوعة لزيادة حد RPM.
أين أجد ملف الووركفلو الجاهز؟
يمكنك تحميل ملف الووركفلو الكامل (المشكلة والحل) من هنا واستيراده مباشرة في n8n.