إذا كنت تبحث عن جميع أسماء نماذج واجهة برمجة تطبيقات Anthropic، فإن الإجابة الأسرع هي: أسماء عرض Claude، ومعرفات النماذج الحالية، واللقطات المؤرخة كلها تسميات تبدو صالحة، ولكن فقط معرف API الدقيق هو الذي ينتمي إلى حقل model. تستخدم Anthropic أسماء Claude المقروءة للإنسان لصفحات المنتج، ومعرفات النماذج المؤرخة لاستدعاءات API القابلة للتكرار، والأسماء المستعارة للترقيات الملائمة. هذه القيم مترابطة، لكنها ليست قابلة للتبديل.
القاعدة العملية بسيطة: استخدم معرف نموذج دقيق عندما تحتاج إلى سلوك قابل للتكرار، واستخدم اسمًا مستعارًا عندما ترغب عمدًا في أن تنقلك Anthropic إلى لقطة أحدث، ولا تنسخ أبدًا اسمًا تسويقيًا في طلب API دون التحقق من قائمة النماذج الرسمية أولاً.
إذا كانت خطوتك التالية هي تنسيق الطلب بدلاً من مخطط التسمية، فاستخدم هذا الدليل مع وثائق واجهة برمجة تطبيقات رسائل Anthropic. إذا كنت تختار سير عمل برمجي موجه لـ Claude، فإن نماذج Claude Code المدعومة هي المتابعة الأفضل.
ما هو اسم نموذج واجهة برمجة تطبيقات Anthropic؟
اسم نموذج واجهة برمجة تطبيقات Anthropic هو المعرف الذي يتم إرساله في معامل model لطلب إلى واجهة برمجة تطبيقات الرسائل. يخبر Anthropic أي عائلة من Claude وأي لقطة يجب معالجة الطلب.
من السهل الخلط بين هذه الأشكال الثلاثة:
| نوع القيمة | مثال | أفضل استخدام |
|---|---|---|
| اسم العرض | Claude Sonnet | التوثيق، واجهة المستخدم للمنتج، المحادثات مع القراء غير التقنيين |
| معرف النموذج الحالي | claude-sonnet-5 |
التكاملات الجديدة التي تستخدم نموذجًا مدرجًا في صفحة النماذج الحالية لـ Anthropic |
| معرف النموذج المؤرخ | claude-haiku-4-5-20251001 |
الاختبارات، سير العمل المنظم، التقييمات، وعمليات الإنتاج التي تتطلب قابلية التكرار |
يتغير الكتالوج الدقيق بمرور الوقت. تعامل مع صفحة النماذج الحالية لـ Anthropic و صفحة إيقاف النماذج كمصدر للحقيقة بدلاً من ترميز قائمة منسوخة من برنامج تعليمي قديم.
أسماء نماذج Claude مقابل معرفات نماذج Claude
أسماء نماذج Claude محسّنة للبشر. “Claude Sonnet” ينقل طبقة المنتج، بينما “Claude Haiku” يشير إلى الطبقة الأسرع والأقل تكلفة. تحتاج API إلى قيمة أكثر دقة لأن العائلة يمكن أن تحتوي على لقطات متعددة، وقواعد توفر إقليمي، وتواريخ تقاعد.
المعرف المؤرخ عادة ما يتضمن:
- عائلة Claude، مثل
opusأوsonnetأوhaiku. - الجيل الرئيسي للنموذج.
- تاريخ الإصدار بصيغة
YYYYMMDD.
على سبيل المثال، claude-haiku-4-5-20251001 يحدد لقطة Haiku 4.5 التي تم إصدارها في 1 أكتوبر 2025. التاريخ جزء من المعرف؛ إنه ليس طابعًا زمنيًا للطلب ولا ينبغي استبداله بالتاريخ الحالي.
بعض كتالوجات النماذج تكشف أيضًا عن معرفات أقصر على مستوى العائلة. إنها ملائمة عندما تريد نموذجًا مدعومًا دون إدارة لقطة مؤرخة بنفسك. المقايضة هي أن المؤشر المُدار من قبل المزود قد يغير السلوك بعد التحديث، لذا تحقق من دلالات المعرف الدقيق الموضح في الكتالوج الحالي لـ Anthropic.
معرفات نماذج Claude الشائعة التي قد تواجهها
معرفات API التالية تم إدراجها كنشطة في صفحة النماذج الحالية لـ Anthropic في 24 يوليو 2026. هذا الجدول هو توجيه في نقطة زمنية، وليس سجلاً دائمًا. تحقق من وثائق Anthropic قبل استخدام أي معرف في أي نشر جديد.
| عائلة Claude | معرف API الحالي | الدور النموذجي |
|---|---|---|
| Claude Opus 4.8 | claude-opus-4-8 |
الاستدلال المعقد والتحليل عالي المخاطر |
| Claude Sonnet 5 | claude-sonnet-5 |
أعباء العمل الإنتاجية للأغراض العامة |
| Claude Haiku 4.5 | claude-haiku-4-5-20251001 |
التصنيف السريع، الاستخراج، والردود القصيرة |
| Claude Opus 4.7 | claude-opus-4-7 |
تكاملات Opus من الجيل الحديث التي لم تنتقل إلى 4.8 |
| Claude Sonnet 4.6 | claude-sonnet-4-6 |
تكاملات Sonnet من الجيل الحديث التي لم تنتقل إلى Sonnet 5 |
هذه معرفات، وليست ضمانات بأن النموذج متاح على كل حساب Anthropic. حتى المعرف المدرج حاليًا يمكن أن يفشل بسبب أذونات الحساب، أو المنطقة، أو الحصة النسبية، أو تغيير لاحق في دورة الحياة. المعرفات المؤرخة قابلة للتكرار طالما كانت مدعومة، ولكن يتم إيقافها في النهاية أيضًا.
كيفية الاختيار بين Opus و Sonnet و Haiku
اختر بناءً على عبء العمل بدلاً من الاسم الأطول:
- Opus: استخدم عندما يبرر الاستدلال الصعب، أو التوليف طويل الشكل، أو قرارات الأدوات الدقيقة زمن انتقال أعلى أو تكلفة أعلى.
- Sonnet: ابدأ هنا لمعظم مساعدي الإنتاج، وسير عمل البرمجة، والتوليد المنظم. عادة ما يكون خط الأساس العملي للجودة إلى زمن الانتقال.
- Haiku: استخدم للتوجيه عالي الحجم، والاستخراج، والاعتدال، وإعادة الكتابة القصيرة، والمهام الأخرى حيث يكون وقت الاستجابة أكثر أهمية من عمق الاستدلال الأقصى.
قم بتشغيل تقييم صغير ضد المطالبات التمثيلية قبل تبديل العائلات. قم بتضمين المدخلات غير الصحيحة، والسياق الطويل، واستدعاءات الأدوات، وإخراج JSON، وسلوك التراجع الذي يستخدمه تطبيقك عندما يفشل الطلب. قد يغير اسم النموذج الذي يبدو كبديل مباشر تنسيق استدعاء الأداة أو سلوك الحالة الحدودية.
استخدم معرف النموذج في طلب API للرسائل
قيمة model تنتمي إلى نص JSON. إنها منفصلة عن رأس إصدار API وعن النموذج المعروض في تطبيق Claude على الويب.
curl https://api.anthropic.com/v1/messages \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "content-type: application/json" \
--data '{
"model": "claude-sonnet-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "اشرح لماذا يجب تثبيت معرفات نماذج API في الإنتاج."
}
]
}'
`
رأس `anthropic-version` يصف عقد API. لا يقوم باختيار نموذج Claude. حافظ على هذين الإعدادين مستقلين في تكوينك حتى لا يؤدي ترقية مكتبة العميل إلى تغيير توجيه النموذج بصمت.
لاستخدام SDK، قم بتعيين نفس المعرف من خلال طريقة إنشاء الرسالة الخاصة بالعميل واحتفظ به في قيمة تكوين خاصة بالبيئة. لا تضع مفتاح API أو معرف نموذج في حزمة متصفح؛ التوجيه من جانب الخادم أسهل في التأمين والاختبار.
## لماذا قد يتوقف معرف نموذج API عن العمل
استجابة `invalid_request_error` أو "لم يتم العثور على النموذج" عادة ما تقع في إحدى هذه الفئات:
### تم استخدام اسم العرض بدلاً من المعرف
`Claude Sonnet` هو تسمية مفيدة ولكنه ليس قيمة طلب موثوقة. استبدله بمعرف أو اسم مستعار مدرج في وثائق المزود.
### تم إيقاف اللقطة
المعرفات المؤرخة قابلة للتكرار فقط طالما كان المزود يدعمها. راقب [جدول الإيقاف](https://docs.anthropic.com/en/docs/about-claude/model-deprecations)، وحدد موعدًا نهائيًا للترحيل، واختبر البديل قبل تاريخ التقاعد.
### لا يمكن للحساب الوصول إلى النموذج
يمكن أن يكون المعرف الصالح غير متاح بسبب أذونات الحساب، أو المنطقة، أو الحصة النسبية، أو سياسة المؤسسة. تحقق من نص الاستجابة وتكوين الحساب بدلاً من تغيير المطالبة.
### يتوقع الموجه اسمًا خاصًا بالمزود
قد تقوم البوابات وواجهات برمجة التطبيقات المتوافقة مع OpenAI بتطبيع أسماء النماذج بشكل مختلف. توثق Anthropic حاليًا `claude-sonnet-5`، بينما قد يكشف مزود آخر عن قيمة ذات نطاق أو اسم مستعار مملوك للمزود. استخدم كتالوج نموذج البوابة ولا تفترض أن معرف Claude قابل للنقل عبر كل نقطة نهاية.
## استخدام سير عمل على غرار Claude من خلال نقطة نهاية متوافقة
إذا كان تطبيقك يستخدم بالفعل شكل عميل OpenAI، يمكن لطبقة التوافق تقليل عمل الترحيل. توفر Novita LLM API [نقطة نهاية متوافقة مع OpenAI](https://novita.ai/llm-api) لتوجيه النماذج مفتوحة المصدر المدعومة من خلال شكل طلب مألوف لمحادثات الإكمال.
هذا لا يعني أن كل معرف نموذج Claude متاح تلقائيًا هناك. اجعل توجيه المزود صريحًا:
```python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["NOVITA_API_KEY"],
base_url="https://api.novita.ai/v3/openai",
)
response = client.chat.completions.create(
model="moonshotai/kimi-k2.5",
messages=[
{"role": "user", "content": "لخص تذكرة الدعم هذه في ثلاث نقاط."}
],
)
print(response.choices[0].message.content)
نمط التصميم المهم هو خريطة المزود/النموذج، وليس سلسلة عامة واحدة:
MODELS = {
"anthropic": "claude-sonnet-5",
"novita": "moonshotai/kimi-k2.5",
}
هذا يتيح لك تقييم نموذج Claude مقابل بديل مفتوح المصدر دون إعادة كتابة منطق الأعمال. قبل التبديل، قارن المخرجات المنظمة، واستدعاءات الأدوات، ومعالجة السياق، وزمن الانتقال، وأنماط الفشل—وليس فقط اسم العرض أو عنوان المعيار.
معرفات النماذج في الخلفيات الوكيلة والصناديق الرملية
عادة ما يستدعي الوكيل النموذج عدة مرات: التخطيط، اختيار الأداة، إصلاح الكود، والرد النهائي. ضع معرف النموذج في تكوين الخلفية، وليس في وسائط الأداة التي يتحكم فيها المستخدم. سجل المزود المختار ومعرف النموذج مع كل تشغيل حتى يمكن إعادة إنتاج التقييم لاحقًا.
عندما ينفذ الوكيل كودًا مولّدًا، ابق توجيه النموذج منفصلاً عن بيئة التنفيذ. يمكن لصندوق الحماية المُدار للوكيل عزل الملفات والحزم والأوامر، بينما يبقى تكوين LLM API في خدمة الوكيل. هذا الفصل يجعل من الممكن تغيير اسم مستعار للنموذج أو اختبار لقطة مثبتة دون تغيير صورة الصندوق الرمل.
للوكلاء في الإنتاج، أضف ثلاث ضمانات:
- تحقق من صحة النموذج المكون عند بدء التشغيل بطلب صغير موثق أو فحص كتالوج المزود.
- احتفظ بمعرف احتياطي تم اختباره واجعل تفعيل الاحتياطي مرئيًا في القياس عن بعد.
- قم بتخزين معرف النموذج، إصدار API، إصدار المطالبة، ومخطط الأداة مع نتائج التقييم.
الأسئلة الشائعة
ما هو اسم نموذج Claude الصحيح لواجهة برمجة التطبيقات؟
استخدم معرف النموذج الدقيق المدرج في الوثائق الحالية لـ Anthropic، مثل claude-sonnet-5 أو المؤرخ claude-haiku-4-5-20251001. لا تستخدم اسم عرض مثل “Claude Sonnet” بمفرده.
هل معرف نموذج Claude المؤرخ أفضل من الاسم المستعار؟
ليس أي منهما أفضل دائمًا. المعرف المؤرخ هو الأفضل لقابلية التكرار وعمليات الإطلاق الخاضعة للرقابة. الاسم المستعار هو الأفضل عندما تريد مؤشر عائلة مُدار ولديك اختبارات انحدار لتحديثات المزود.
هل يمكنني استخدام معرفات نموذج Anthropic مع API متوافقة مع OpenAI؟
فقط إذا كانت نقطة النهاية تلك تدعم وتوثق المعرف بشكل صريح. التوافق مع OpenAI يصف واجهة الطلب؛ لا يعد بكتالوجات نماذج متطابقة. تحقق من النماذج المدعومة لنقطة النهاية واستخدم اسم التوجيه الدقيق الخاص بها.
كيف أمنع إيقاف نموذج من تعطيل تطبيقي؟
ثبت معرفًا تم اختباره، وراقب إشعارات إيقاف Anthropic، واختبر البديل قبل تاريخ التقاعد، واحتفظ بقيمة النموذج في التكوين حتى تتمكن من تغييرها دون نشر تغييرات في منطق الأعمال.
