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

ذاكرة العضلات من خمس سنوات صيد للأخطاء المطبعية تقول افحص إملاءك. لكن المعدّل الأساسي في 2026 يقول افحص تقويم الإيقاف أولاً — فالمعرّف الذي تستدعيه قد يكون تقاعد في موعده تماماً.

بقلم فريق 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);
}

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

أسئلة شائعة

لماذا يُرجع كودٌ كان يعمل أمس خطأ 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: المُدخَل المقروء آلياً لهذا الخطأ