عرض 15 من 15 خطأً
"You exceeded your current quota" — الفوترة فارغة؛ إعادة المحاولة لا تصلحها.
rate_limit_exceededبلغت سقف RPM أو TPM. مؤقت — الحدود تُعاد كل دقيقة.
context_length_exceededالموجّه زائداً max_tokens تجاوزا نافذة النموذج.
model_not_foundمعرّف خاطئ، نقطة وصول خاطئة، لا صلاحية — أو نموذج تقاعد في OpenAI.
invalid_api_key"Incorrect API key provided" — المفتاح خاطئ أو مُلغى أو مشوّه.
overloaded_errorضغط على مستوى المنصة كلها، لا على حسابك. تراجع وانتظر زواله.
rate_limit_errorسقف المستوى — أو حدود التسارع إذا تصاعد استخدامك بحدّة مفرطة.
invalid_request_errorفي 2026: معاملات المعاينة على Opus 4.7+، أو الـ prefill، أو كتل تفكير معدَّلة.
request_too_largeجسم الطلب فوق سقف 32 MB لواجهة Messages — مرفوض قبل أن تراه Anthropic.
not_found_errorمنذ 15 يونيو 2026 صار السبب الأول معرّف نموذج Claude متقاعد.
RESOURCE_EXHAUSTEDخطأ الطبقة المجانية المميَّز: طلبات في الدقيقة أكثر مما يسمح به مستواك.
INVALID_ARGUMENTجسم مشوّه — أو ميزة لا وجود لها في إصدار API لديك.
NOT_FOUNDمراجع ملفات منتهية — أو نموذج من سلسلة أوقفتها Google أصلاً.
DEADLINE_EXCEEDEDموجّهات ضخمة تجاوزت الساعة. استخدم البث، أو قلّص، أو ارفع المهلة.
FAILED_PRECONDITIONالطبقة المجانية غير متاحة في منطقتك من دون تفعيل الفوترة.
الحصة وحدود الاستخدام: الـ 429 اللذان يحتاجان حلَّين متعاكسين
يرسل OpenAI كلاً من حدود الاستخدام ونفاد الفوترة بحالة HTTP 429، والخلط بينهما يهدر ساعات: التراجع يشفي الأول ولا يفعل شيئاً للثاني. وتضيف Anthropic التواءً يستحق المعرفة — حدود التسارع التي تنطلق حين يتصاعد الاستخدام بحدّة مفرطة، حتى تحت سقفك. إذا ظلت الحدود تكبّلك، فالمخرج العملي توجيه التدفق الضخم إلى مستويات أرخص وأعلى إنتاجية: قارن تكلفة ذلك في الحاسبة مع الترتيب الحالي.
النموذج غير موجود: أسرع خطأ نمواً في 2026
ثلاثة مزوّدين يقاعدون سلاسل نماذج هذا العام — أُظلمت Claude Sonnet 4 وOpus 4 في 15 يونيو، وتنتهي سلسلة Gemini 2.5 في 16 أكتوبر، ويقاعد OpenAI تسعة معرّفات في 23 أكتوبر. كل 404 في هذه الفئة (OpenAI، Anthropic، Gemini) يربط بـسجل الإيقافات، حيث يحمل كل تقاعد بديله وحساب السعر قبل وبعد. ويُظهر المتعقّب الحي الحالة الراهنة لكل نموذج.
السياق أكبر من اللازم
تجاوز التوكنز (context_length_exceeded) وتجاوز البايتات (request_too_large) يفشلان بطريقتين مختلفتين ويحتاجان حلَّين مختلفين — عدّ التوكنز مقابل قياس الحمولة. حين لا يكون التقليص خياراً، فالحل نافذة أوسع: مقارنة نوافذ السياق تُظهر ما تساويه فعلاً نافذة كل نموذج المعلنة في الواقع.
جدران المصادقة والفوترة
إخفاقات المصادقة (أخطاء 401) أرخص الأخطاء منعاً وأكثرها إحراجاً عند تصحيحها منتصف الليل. وأما FAILED_PRECONDITION في Gemini فهو حيوان من نوعه — جدار منطقة وفوترة يضربك لحظة نشرك على خادم خارج تغطية الطبقة المجانية.
أخطاء الخادم والحِمل الزائد
الخطأ 529 من Anthropic و504 من Gemini هما المنصة تخبرك عن نفسها، لا عن كودك. أعد المحاولة بأدب، وإذا ظلت ساعات الذروة لدى مزوّد تؤذيك، فإن سجل تاريخ الأسعار والترتيب يبنيان الحجة لإبقاء مزوّد ثانٍ موصولاً كبديل احتياطي.