# أخطاء AI API: ‏401 و429 و5xx وانتهاء المهلة

افصل المصادقة والحصة وحدود المعدل والأخطاء العابرة لواجهات OpenAI وClaude وGemini. استخدم التفاصيل قبل تقرير المحاولة.

بواسطة IsAnythingDown. روجع 2026-10-06.

الصفحة الأساسية: https://isanythingdown.com/ar/guides/ai-api-error-codes

## إجابة سريعة

لا يثبت خطأ API وحده عطلًا لدى المزوّد. اقرأ نص خطأ المزوّد ومعرّف الطلب، ثم افحص مكوّن الحالة المطابق. تحتاج مشكلات المصادقة والفوترة إلى تغييرات في الإعدادات؛ وقد تبرر الأخطاء العابرة إعادة محاولات محدودة.

## ابدأ بفئة الخطأ

استخدم الجدول لاختيار فحص أول. تعتمد المعاني والعلاجات الدقيقة على المزوّد ونقطة النهاية ونص الخطأ.

| ما الذي تراه | الفحص الأول | ما الذي لا يثبته |
| --- | --- | --- |
| 400 / 404 / 413 | صيغة الطلب ونقطة النهاية والمورد والحجم؛ اقرأ خطأ المزوّد | عطل عام في الخدمة |
| 401 / 403 | بيانات الاعتماد وأذونات الوصول وقيود كل مزوّد | أن كل المستخدمين محظورون |
| 429 | ترويسات حد المعدل والحصة والرصيد وحدود الإنفاق | أن إعادة المحاولة فورًا ستنجح |
| 500 / 503 / 529 | تفاصيل خطأ المزوّد والمكوّن الرسمي المعني | حدث عالمي مؤكد |
| انتهاء المهلة / خطأ اتصال | مهلة العميل وDNS وTLS والوكيل ومدة الطلب | أي طرف سبب الفشل |
- [رموز أخطاء OpenAI API](https://developers.openai.com/api/docs/guides/error-codes)
- [أخطاء Claude API](https://platform.claude.com/docs/en/api/errors)
- [استكشاف أخطاء Gemini API](https://ai.google.dev/gemini-api/docs/troubleshooting)

## OpenAI: قد يعني 429 حدودًا مختلفة

افحص error.code، لا HTTP 429 وحده. تفرّق OpenAI حدود معدل الطلبات عن نفاد الرصيد وحدود المؤسسات والمشاريع. لا تُصلح المحاولات المتكررة الفوترة والحصص. لحدود عابرة أو حمل زائد احترم Retry-After عند وجوده وحدّد المحاولات.

استخدم إدراج OpenAI API لمكوّنات API. لا يؤكد إدراج تطبيق ChatGPT نتيجة طلب API أو صحة نموذج GPT محدد.

- [رموز أخطاء OpenAI API](https://developers.openai.com/api/docs/guides/error-codes)
- [تقرير مكوّنات OpenAI API](https://isanythingdown.com/ar/services/openai)

## Claude: الحمل الزائد وحدود الإنفاق مختلفان

يوثّق Claude ‏529 كحمل زائد و401 كفشل مصادقة و403 كفشل أذونات. قد يعكس 429 حد معدل أو إنفاق. استجابة 429 الخاصة بحد إنفاق فئة الاستخدام بلا ترويسة Retry-After وتظل تفشل حتى استئناف الوصول. اقرأ الخطأ كاملًا قبل اختيار سياسة المحاولة.

للاستجابات المتدفقة، توثّق Claude إمكان حدوث خطأ بعد HTTP 200. افحص اكتمال التدفق وأحداث الخطأ؛ استلام الترويسات وحده لا يثبت نجاح التوليد.

- [أخطاء Claude API](https://platform.claude.com/docs/en/api/errors)

## Gemini: تحقق من نقطة المطوّرين

توصي Google بتراجع أُسّي محدود مع عشوائية للأخطاء العابرة. افحص أيضًا إصدار API والنموذج والمعاملات المدعومة. راجع تقرير developer API نفسه؛ لا يغطي موجز أحداث تطبيق Gemini طلبات Gemini API أو AI Studio.

- [استكشاف أخطاء Gemini API](https://ai.google.dev/gemini-api/docs/troubleshooting)
- [حالة Gemini API / AI Studio الرسمية](https://aistudio.google.com/status)

## حدّد ميزانية للمحاولات

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

قبل إعادة طلب انقطع، تحقق مما إذا كان قد أنتج مخرجات أو تكلفة أو إجراءً لاحقًا بالفعل. إعادة محاولة طلب نموذج وتكرار إجراء أداة للوكيل قراران منفصلان. احتفظ بمعرّفات الطلبات لاستكشاف الأخطاء، وأوقف المحاولات الآلية عند نفاد الميزانية المسموح بها.

- [رموز أخطاء OpenAI API](https://developers.openai.com/api/docs/guides/error-codes)
- [استكشاف أخطاء Gemini API](https://ai.google.dev/gemini-api/docs/troubleshooting)

## استكشف خطأ استجابة محددة

استخدم دليلًا مخصصًا للخطأ الذي أعاده طلبك. تشرح الصفحات أخطاء الطلب ولا تراقب حدود الحساب.

- [خطأ AI API ‏429](https://isanythingdown.com/ar/guides/ai-api-error-429)
- [خطأ AI API ‏500](https://isanythingdown.com/ar/guides/ai-api-error-500)
- [خطأ AI API ‏503](https://isanythingdown.com/ar/guides/ai-api-error-503)
- [خطأ AI API ‏529](https://isanythingdown.com/ar/guides/ai-api-error-529)

## صفحات خدمات ذات صلة

- [OpenAI API](https://isanythingdown.com/ar/services/openai)
- [Claude](https://isanythingdown.com/ar/services/claude)
- [Gemini API / AI Studio](https://isanythingdown.com/ar/services/gemini-api)
- [OpenRouter](https://isanythingdown.com/ar/services/openrouter)

يعرض كل إدراج تغطية الجمع الخاصة به. الخدمة المرتبطة ليست بالضرورة مُجمّعة آليًا.

ينطبق تاريخ المراجعة التحريرية على هذا الدليل. تظهر أوقات جمع التقارير الحالية في صفحات الخدمات.