برمجة نظام لتدوير مفاتيح Gemini API تلقائيًا عند ظهور خطأ 429 (PHP)

أملك موقع مبني بلغة PHP يستخدم واجهة Google Gemini API، ولكن أواجه مشكلة متكررة وهي ظهور الخطأ 429 (Too Many Requests) بسبب محدودية عدد الطلبات اليومية لكل مفتاح API.

أحتاج مطور محترف يقوم ببرمجة نظام ذكي لتدوير مفاتيح الـ API تلقائيًا بحيث:

المطلوب بالتفصيل:

1. عند حدوث خطأ 429 في أحد المفاتيح، يتم الانتقال فورًا إلى المفتاح التالي في القائمة.

2. إذا وصل لآخر مفتاح، يبدأ من الأول من جديد (دورة مستمرة).

3. يتم حفظ حالة المفتاح الحالي (index) في ملف أو قاعدة بيانات بحيث يستكمل من آخر نقطة حتى بعد إعادة تشغيل السيرفر.

4. يجب أن يدعم النظام تعدد الطلبات في نفس الوقت (Concurrency) بدون تعارض بين الطلبات.

5. في حال فشل جميع المفاتيح (بعد مرورها كلها)، يرجع خطأ واضح أو إشعار إداري.

6. الكود يكون نظيف وآمن وقابل للتوسّع مستقبلاً (لإضافة مفاتيح جديدة بسهولة).

7. أرغب أن يكون الحل مبرمجًا داخل موقعي (PHP)، بدون الاعتماد على أدوات خارجية