أخطاء AI API: 401 و429 و5xx وانتهاء المهلة
افصل المصادقة والحصة وحدود المعدل والأخطاء العابرة لواجهات OpenAI وClaude وGemini. استخدم التفاصيل قبل تقرير المحاولة.
إجابة سريعة
لا يثبت خطأ API وحده عطلًا لدى المزوّد. اقرأ نص خطأ المزوّد ومعرّف الطلب، ثم افحص مكوّن الحالة المطابق. تحتاج مشكلات المصادقة والفوترة إلى تغييرات في الإعدادات؛ وقد تبرر الأخطاء العابرة إعادة محاولات محدودة.
ابدأ بفئة الخطأ
استخدم الجدول لاختيار فحص أول. تعتمد المعاني والعلاجات الدقيقة على المزوّد ونقطة النهاية ونص الخطأ.
| ما الذي تراه | الفحص الأول | ما الذي لا يثبته |
|---|---|---|
| 400 / 404 / 413 | صيغة الطلب ونقطة النهاية والمورد والحجم؛ اقرأ خطأ المزوّد | عطل عام في الخدمة |
| 401 / 403 | بيانات الاعتماد وأذونات الوصول وقيود كل مزوّد | أن كل المستخدمين محظورون |
| 429 | ترويسات حد المعدل والحصة والرصيد وحدود الإنفاق | أن إعادة المحاولة فورًا ستنجح |
| 500 / 503 / 529 | تفاصيل خطأ المزوّد والمكوّن الرسمي المعني | حدث عالمي مؤكد |
| انتهاء المهلة / خطأ اتصال | مهلة العميل وDNS وTLS والوكيل ومدة الطلب | أي طرف سبب الفشل |
OpenAI: قد يعني 429 حدودًا مختلفة
افحص error.code، لا HTTP 429 وحده. تفرّق OpenAI حدود معدل الطلبات عن نفاد الرصيد وحدود المؤسسات والمشاريع. لا تُصلح المحاولات المتكررة الفوترة والحصص. لحدود عابرة أو حمل زائد احترم Retry-After عند وجوده وحدّد المحاولات.
استخدم إدراج OpenAI API لمكوّنات API. لا يؤكد إدراج تطبيق ChatGPT نتيجة طلب API أو صحة نموذج GPT محدد.
Claude: الحمل الزائد وحدود الإنفاق مختلفان
يوثّق Claude 529 كحمل زائد و401 كفشل مصادقة و403 كفشل أذونات. قد يعكس 429 حد معدل أو إنفاق. استجابة 429 الخاصة بحد إنفاق فئة الاستخدام بلا ترويسة Retry-After وتظل تفشل حتى استئناف الوصول. اقرأ الخطأ كاملًا قبل اختيار سياسة المحاولة.
للاستجابات المتدفقة، توثّق Claude إمكان حدوث خطأ بعد HTTP 200. افحص اكتمال التدفق وأحداث الخطأ؛ استلام الترويسات وحده لا يثبت نجاح التوليد.
Gemini: تحقق من نقطة المطوّرين
توصي Google بتراجع أُسّي محدود مع عشوائية للأخطاء العابرة. افحص أيضًا إصدار API والنموذج والمعاملات المدعومة. راجع تقرير developer API نفسه؛ لا يغطي موجز أحداث تطبيق Gemini طلبات Gemini API أو AI Studio.
حدّد ميزانية للمحاولات
كخيار في تصميم التطبيق، حدّد أقصى عدد للمحاولات وميزانية زمنية إجمالية. احسب المحاولات التي أجراها SDK بالفعل. استخدم تأخيرًا بتراجع أُسّي وعشوائية للأخطاء التي يصفها المزوّد بأنها عابرة، واحترم ترويسات إعادة المحاولة ذات الصلة.
قبل إعادة طلب انقطع، تحقق مما إذا كان قد أنتج مخرجات أو تكلفة أو إجراءً لاحقًا بالفعل. إعادة محاولة طلب نموذج وتكرار إجراء أداة للوكيل قراران منفصلان. احتفظ بمعرّفات الطلبات لاستكشاف الأخطاء، وأوقف المحاولات الآلية عند نفاد الميزانية المسموح بها.
استكشف خطأ استجابة محددة
استخدم دليلًا مخصصًا للخطأ الذي أعاده طلبك. تشرح الصفحات أخطاء الطلب ولا تراقب حدود الحساب.
صفحات خدمات ذات صلة
يعرض كل إدراج تغطية الجمع الخاصة به. الخدمة المرتبطة ليست بالضرورة مُجمّعة آليًا.
ينطبق تاريخ المراجعة التحريرية على هذا الدليل. تظهر أوقات جمع التقارير الحالية في صفحات الخدمات.