أربعة أسباب محتملة
يظهر الخطأ 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);
}
احتفظ بمعرّف النموذج في إعداد مركزي أو متغير بيئة بدلاً من تكراره في مواضع الاستدعاء. عند وصول موعد إيقاف منشور، يصبح التبديل تغييراً واضحاً في مكان واحد مع اختبار ونشر منظمين.