خطأ not_found_error من Anthropic: المعنى والسبب والحل

موجة الإيقاف وراء أخطاء 404

أوقفت Anthropic المعرّفين claude-sonnet-4-20250514 وclaude-opus-4-20250514 في 15 يونيو 2026، ولذلك بدأت الطلبات إليهما تفشل بعد ذلك التاريخ. وتبعهما claude-opus-4-1-20250805 في 5 أغسطس 2026. يعرض المتتبّع القائمة الكاملة ومواعيدها.

وجّه المسار المسجّل لدى Anthropic حركة Sonnet 4 إلى claude-sonnet-4-6 بالسعر نفسه: $3 للإدخال و$15 للإخراج لكل مليون توكن، مع نافذة سياق بمليون توكن، وحركة Opus 4 و4.1 إلى claude-opus-4-8 بسعر $5 / $25 بدلاً من $15 / $75. تدرج Anthropic الآن Sonnet 4.6 وOpus 4.8 ضمن النماذج القديمة مع بقائهما متاحين. وللشيفرة الجديدة يختار benchr تحريرياً Claude Sonnet 5 بسعر $2 / $10 لكل مليون توكن، وهو أرخص من Sonnet 4.6 في الإدخال والإخراج، أو Claude Opus 5 بسعر $5 / $25، وهو سعر Opus 4.8 نفسه. وتوجّه إرشادات Anthropic نفسها معظم الأحمال إلى Opus 5. يشرح دليل Sonnet 4 ودليل Opus 4 و4.1 خطوات الانتقال. وتنطبق هذه التواريخ على Claude API وAWS وMicrosoft Foundry؛ أما Bedrock وVertex AI فلهما جداول منفصلة.

محتوى الرد

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "The requested resource could not be found."
  },
  "request_id": "req_..."
}

تلك الجملة هي كل ما تحصل عليه؛ الجسم لا يسمّي المورد المفقود أبداً، ولهذا يأتي فحص معرّف النموذج أولاً. ترفع الـ SDKs استثناءات معنونة (anthropic.NotFoundError في بايثون)، وكل رد يحمل ترويسة request-id تبدأ بـ req_. اقتبسها حين تتواصل مع الدعم — فهي أسرع طريق إلى أن يرى أحدهم طلبك بعينه.

افحص الأسباب الأخرى

قبل أن تفترض أن النموذج تقاعد، راجع الأخطاء البسيطة: حرف خاطئ في المعرّف، أو مسار غير صحيح (/v1/message بدلاً من /v1/messages)، أو معرّف ملف أو دفعة حُذف أو يعود إلى مساحة عمل أخرى. تستخدم الواجهة الرسالة نفسها لهذه الحالات، لذا يلزم فحص إعدادات الطلب.

راجع قبل أكتوبر

تغيير المعرّف يعالج الخطأ الحالي، لكن مراجعة الاستخدام تمنع تكراره. يبيّن تصدير الاستخدام في Console الاستدعاءات بحسب مفتاح API والنموذج؛ وكل ما يزال يستدعي معرّفاً متقاعداً يحتاج إلى ترحيل، وكذلك Claude Sonnet 4.5 الذي تدرج Anthropic تقاعده في موعد لا يسبق 29 سبتمبر 2026. احتفظ بمعرّفات النماذج في إعداد مركزي وحدّد المسؤول عنها، واشترك في خلاصة الإيقافات لمتابعة المواعيد الجديدة.

# config.yaml
-  model: claude-sonnet-4-20250514    # retired June 15, 2026
+  model: claude-sonnet-5             # $2/$10, 1M context

# Confirm an ID exists before you ship it
curl https://api.anthropic.com/v1/models \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01"

إن لم يكن المعرّف الذي توشك نشره في تلك القائمة، فقد وجدت خطأك 404 قبل أن يجده الإنتاج.