OpenAI model_not_found: معناه وسببه وحله

الخطأ في كتابة المعرّف ليس السبب الوحيد. فقد يكون النموذج غير متاح على نقطة الوصول، أو غير متاح للمشروع، أو قد تقاعد.

بقلم فريق benchr · · متحقَّق منه مقابل توثيق الأخطاء من OpenAI، 12 يونيو 2026

OpenAIHTTP 404الخطورة: عاليةتوفر النموذج

أربعة أسباب محتملة

يظهر الخطأ 404 في أربع حالات: تقاعد المعرّف، أو وجود خطأ في كتابته أو في لاحقة الإصدار، أو استخدام نقطة وصول لا يدعمها النموذج، أو غياب صلاحية الوصول للحساب أو المنطقة. فبعض نماذج 2026 تعمل عبر Responses API فقط وتُرجع 404 على /v1/chat/completions. ويبدو الرد متشابهاً في الحالات الأربع.

ابدأ بسجل الإيقافات، لأن تسعة معرّفات لها موعد إيقاف واحد في أكتوبر، كما يتوقف Assistants API في 26 أغسطس 2026. بعد استبعاد التقاعد، افحص المعرّف ونقطة الوصول ثم صلاحية الحساب.

ما الذي يُرجعه

HTTP/1.1 404 Not Found

{
  "error": {
    "message": "The model `gpt-4o-2024-05-13` does not exist or you do not have access to it.",
    "type": "invalid_request_error",
    "code": "model_not_found"
  }
}

الصياغة تؤدي مهمتين معاً: "does not exist or you do not have access" تغطّي كل سبب دون أن تكشف أيّها ينطبق عليك. والمعرّف بين علامتي backtick يردّد ما حمله طلبك، فلاحقة لقطة قديمة أو حرف مبدَّل يظهر في صلب نص الخطأ.

افحص سجل الإيقافات أولاً

23 أكتوبر 2026 هو التاريخ المهمّ. يسرد سجل إيقافات benchr تسعة معرّفات OpenAI تُظلِم ذلك اليوم: gpt-4o-2024-05-13، gpt-4-0613، gpt-4-turbo، gpt-4-1106-preview، gpt-3.5-turbo-0125، o1، o1-pro، o3-mini، وo4-mini. البديلان الرسميان هما GPT-5.5 وGPT-5.4 mini.

إذا كان معرّفك على تلك القائمة، فقد انتهيت من التشخيص. سجل موجة التقاعد يربط كل معرّف بخلفه، وصفحة gpt-4o تغطّي الهجرة الأكثف تدفقاً، والمتعقّب يُظهر أي إيقافات تأتي تالياً كي لا يفاجئك خطأ 404 القادم أيضاً.

إصلاح الإعداد

النسخة المتينة من هذا الحل فحصٌ عند الإقلاع: اسأل الـ API عمّا يستطيع مفتاحك رؤيته، وارفض الإقلاع على معرّف غير موجود فيها.

// Node: verify the configured model at startup
const MODEL = process.env.OPENAI_MODEL ?? "gpt-5";

const res = await fetch("https://api.openai.com/v1/models", {
  headers: { Authorization: `Bearer ${process.env.OPENAI_API_KEY}` },
});
const { data } = await res.json();

if (!data.some((m) => m.id === MODEL)) {
  console.error(`Model "${MODEL}" is not available to this key.`);
  console.error("Retired? Official replacements: GPT-5.5 or GPT-5.4 mini.");
  process.exit(1);
}

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

أسئلة شائعة

لماذا يُرجع كودٌ كان يعمل أمس خطأ 404 اليوم؟

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

هل يعني خطأ 404 هذا أن مفتاح API لديّ سيّئ؟

لا. المفتاح السيّئ يفشل بحالة 401 قبل أن يحدث أي بحث عن النموذج. حصولك على 404 يعني أن المصادقة نجحت وأن النموذج هو المفقود أو المتقاعد أو المحجوب عن حسابك.

إلى أين يجب أن ينتقل تدفق gpt-4o؟

البديل الرسمي من OpenAI هو GPT-5.5. أما اختيار benchr المطابق للتكلفة فهو GPT-5 بـ ‎$1.25‎ إدخالاً و‎$10‎ إخراجاً لكل مليون توكن، وهو أقرب بكثير لفواتير حقبة gpt-4o. سجل gpt-4o يمشي على كلا المسارين.

سجل التغييرات

  • — نُشر. تم فحص نمط الرسالة ورمز الحالة وقائمة تقاعد 23 أكتوبر مقابل توثيق أخطاء OpenAI وسجل إيقافات benchr.

المصادر

  • OpenAI error codes guide: developers.openai.com/api/docs/guides/error-codes (تم التحقق في 12 يونيو 2026)
  • OpenAI deprecations: developers.openai.com/api/docs/deprecations (تم التحقق في 12 يونيو 2026)
  • benchr api-errors.json: المُدخَل المقروء آلياً لهذا الخطأ