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

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

بقلم فريق benchr · · تم التحقق من توثيق أخطاء API لدى Anthropic في 12 يونيو 2026

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

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

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

البدائل الرسمية واضحة. ينتقل Sonnet 4 إلى claude-sonnet-4-6 بالسعر نفسه: 3$ للإدخال و15$ للإخراج لكل مليون توكن، مع نافذة سياق بمليون توكن. وينتقل Opus 4 و4.1 إلى claude-opus-4-8 بسعر 5$/25$ بدلاً من 15$/75$. يشرح دليل 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-opus-4-1-20250805 يحتاج إلى ترحيل. احتفظ بمعرّفات النماذج في إعداد مركزي وحدّد المسؤول عنها، واشترك في خلاصة الإيقافات لمتابعة المواعيد الجديدة.

# config.yaml
-  model: claude-sonnet-4-20250514    # retired June 15, 2026
+  model: claude-sonnet-4-6           # same $3/$15, 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 قبل أن يجده الإنتاج.

أسئلة شائعة

كان كودي يعمل الجمعة وبدأ يُرجع أخطاء 404 الاثنين. ما الذي تغيّر؟

إن كان النموذج claude-sonnet-4-20250514 أو claude-opus-4-20250514، فالجواب 15 يونيو 2026. أُوقف كلاهما ذلك اليوم، والمعرّفات المُوقَفة تفشل تماماً بدل أن تُعيد التوجيه. بدّل إلى claude-sonnet-4-6 أو claude-opus-4-8 فتعود الاستدعاءات.

هل البديل أغلى؟

لا. يحافظ claude-sonnet-4-6 على تسعير Sonnet 4 البالغ 3$/15$ ويضيف نافذة سياق بمليون توكن. ويفوتر claude-opus-4-8 بـ 5$/25$ مقابل 15$/75$ التي كان يتقاضاها Opus 4 و4.1، أي أرخص بنحو الثلثين.

هل تتطابق تواريخ Bedrock وVertex مع هذه؟

لا. 15 يونيو و5 أغسطس تنطبق على Claude API وAWS وMicrosoft Foundry. أما Amazon Bedrock وGoogle Vertex AI فيحتفظان بجداول إيقاف خاصة بهما، فتحقق من تلك اللوحات على حدة.

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

  • — نُشر. تم التحقق من جسم الخطأ، وتواريخ الإيقاف، وتسعير البدائل، وفق توثيق أخطاء API وإيقاف النماذج لدى Anthropic.

المراجع

  • Anthropic API errors · platform.claude.com/docs/en/api/errors (تم التحقق في 12 يونيو 2026)
  • Anthropic model deprecations · platform.claude.com/docs/en/about-claude/model-deprecations (تم التحقق في 12 يونيو 2026)
  • benchr api-errors.json · السجل المُهيكَل لهذا الخطأ