واجهة Claude Fable 5.2 API تتيح لك إضافة قدرات تفكير متقدمة إلى مساعدين للبرمجة، وسير عمل البحث، والتطبيقات التي تحتاج عملاً متعدد الخطوات على مدى طويل. يمكنك الاتصال مباشرةً بـ Anthropic أو استخدام CometAPI، بحسب الطريقة التي تريد بها إدارة الوصول إلى النموذج والتكامل.
لخفض تكلفة الرموز وتبسيط التكامل متعدد النماذج، فإن Claude Fable 5.2 API عبر CometAPI نقطة بداية عملية: أسعار الإدخال والإخراج المنشورة أقل بنسبة 20% من أسعار واجهة Anthropic القياسية، ويمكنك الإبقاء على تنسيق طلب Messages من Anthropic ضمن سير موحّد للوصول إلى النماذج والفوترة. اختر الوصول المباشر إلى Anthropic عندما تكون عناصر التحكم الخاصة بالمزوّد أو ميزة أصلية هي متطلباتك الأساسية.
يتناول هذا الدليل كلا المسارين، ثم يستعرض طلبات Python، والبث، وسجل المحادثة، وإدخال الصور، وفحوصات الإنتاج. ستحتاج إلى Python 3.10 أو أحدث، ومفتاح API للمسار الذي اخترته، وإتاحة الوصول إلى claude-fable-5-2.
النقاط الأساسية
يستخدم Claude Fable 5.2 API معرّف النموذج claude-fable-5-2 على كلا المسارين المعروضين هنا.
تمت المراجعة للوضوح ودقة المصدر ومصطلحات API الحالية.
الوصول المباشر إلى Anthropic وCometAPI يستخدمان مفاتيح وفوترة منفصلة؛ اختر مساراً قبل إرسال الطلب.
CometAPI مناسبة للتطبيقات متعددة المزوّدين عبر بيانات اعتماد مشتركة، وفوترة موحّدة، وواجهات API متوافقة.
ابدأ بطلب نصي واحد، ثم أضف إعدادات التفكير، والبث، وسجل المحادثة، والصور حسب الحاجة.
يقلّل CometAPI رسوم رموز Claude Fable 5.2 بنسبة 20% مقارنة بالأسعار القياسية الرسمية أدناه، بما في ذلك عمليات التخزين المؤقت المدرجة.
ما هي Claude Fable 5.2 API؟
Claude Fable 5.2 هو نموذج التفكير من Anthropic للعمل التقني المتطلب. تم إصداره في 9 نوفمبر 2026. تمنحك API وصولاً إلى النموذج من دون تشغيل بنية النموذج التحتية بنفسك.
تشمل المشاريع الأولية المعتادة مراجعة تغيير في مستودع، وتحليل مجموعة من المستندات، وشرح تصميم نظام معقّد. يبدأ كل منها بطلب واستجابة؛ ويمكن إضافة الأدوات وحلقات محادثة أطول بعد أن يعمل هذا المسار.
مواصفات Claude Fable 5.2 API
المواصفة
المواصفات الرسمية لـ Claude Fable 5.2
معرّف النموذج
claude-fable-5-2
نافذة السياق
1M tokens
الحد الأقصى للإخراج
128K tokens
الإدخال/الإخراج
نص وصور / نص
التفكير
تكيفي؛ مفعّل دائماً
جهد API الافتراضي
high
تنسيق الطلب الأساسي في هذا الدليل
Anthropic Messages
تصف حدود السياق والإخراج القدرة، لا أحجام الطلب المقترحة. استخدم مطالبة قصيرة وميزانية إخراج متواضعة بينما تتحقق من بيانات الاعتماد ومعالجة الاستجابة.
ما الجديد في Claude Fable 5.2 API مقارنةً بـ Fable 5.1؟
إذا كنت تستخدم Fable 5.1 بالفعل، فإن الترقية تتمحور أساساً حول أداء أفضل للمهام، وأسعار رموز قياسية أقل، وتغييرات في التوافق مع المحادثة والأدوات. يستخدم الجدول أدناه Fable 5.1 كجيل سابق.
نتائج أقوى في المهام التقنية المتطلبة
في تقييمات الإصدار لدى Anthropic، حقق Fable 5.2 نسبة 49.1% على FrontierCode 2.0 مقابل 32.4% لـ Fable 5.1، كليهما عند xhigh effort. ارتفعت درجات Chartography من 44.8% إلى 73.4%. وتفيد Anthropic أيضاً بأن توليد المخرجات أسرع بما يصل إلى 30% مقارنةً بالإصدار 5.1 مع وضع سريع اختياري. هذه نتائج من المزوّد؛ التسريع في التوليد لا يضمن زمناً أقصر لطلبك الشامل.
لمراجعة مستودع أو مهمة تحليل مستندات صعبة، اختبر ما إذا كان النموذج الجديد يلتقط أخطاءً يفوتها نموذجك الحالي. حافظ على مطالباتك ومدخلاتك ومعايير التقييم ثابتة كي يجيب القياس عن سؤال عملي: هل ينجز مزيداً من عملك الحقيقي بنجاح؟
أسعار قياسية أقل من Fable 5.1
الأسعار القياسية المنشورة لدى Anthropic تنخفض من $10 إلى $8 لكل مليون رمز إدخال، ومن $50 إلى $40 لكل مليون رمز إخراج. وتنخفض قراءات الكاش من $0.25 إلى $0.20. كل منها انخفاض بنسبة 20%. هذه أسعار رسمية بين جيل وآخر؛ المقارنة اللاحقة مع CometAPI تقيس فرقاً منفصلاً بين مزوّدي الوصول.
عند استخدام غير متغير لـ 100,000 رمز إدخال و10,000 رمز إخراج، ينخفض طلب قياسي بلا كاش من $1.50 على Fable 5.1 إلى $1.20 على Fable 5.2. تعتمد الوفورات الفعلية على الرموز المُولّدة، وإعادة المحاولة، والتخزين المؤقت، والأوضاع الاختيارية.
التحققات من المحادثة تغطي الآن كل الحسابات. قد يفشل إعادة تشغيل التفكير بعد تحرير رسائل سابقة، أو تعليمات النظام، أو الأدوات، بما في ذلك على الحسابات القديمة التي كانت تنجح سابقاً.
التراجع لا يحفظ كل التفكير. لا يستطيع قراءة كتل التفكير الخاصة بـ Fable 5.2 إلا Fable 5.2 وMythos 5.2. قد يؤدي التبديل إلى 5.1 أو نموذج آخر إلى فقدان هذا التفكير.
استخدام الحاسوب يتطلب مجموعة الأدوات الأحدث. الأداة القديمة computer_20251124 تفشل خارج Amazon Bedrock؛ استخدم computer_toolset_20260801 وعدّل حلقة الأداة.
تغييرات توافق المستشار. يتطلب منفّذ Fable 5.2 مستشار Fable 5.2 أو Mythos 5.2.
ما الذي بقي كما هو
تتضمن مواصفات Fable 5.1 بالفعل نافذة سياق 1M token، وإخراجاً أقصاه 128K، وإدخال نص وصور، وتفكيراً تكيفياً دائماً، وجهداً عالياً افتراضياً لـ API. تبقى هذه قدرات مفيدة في 5.2، لكنها ليست أسباباً جديدة للترحيل.
كيف تهاجر إلى Claude Fable 5.2 API—وهل يستحق الأمر؟
ابدأ بهجرة صغيرة قابلة للقياس والعكس. الطلب الأول الناجح ليس سوى البداية: يحتاج تطبيقك أيضاً إلى الحفاظ على حالة المحادثة، وإتمام سير عمل الأدوات، والتعامل مع الرجوع الاحتياطي بشكل صحيح.
غيّر النموذج في إعداد اختبار. عيّن MODEL إلى claude-fable-5-2 في client_config.py المستخدم أدناه. أبقِ مفتاح المسار المختار وعنوان الأساس معاً. شغّل محادثة قصيرة وجديدة أولاً.
راجع خيارات الطلب. في عمليات التكامل الأقدم، أزل التفكير المُعطّل أو المُدار يدوياً، وPrefills المساعد، وفرض اختيار الأدوات. أحذف temperature وtop_p وtop_k. استخدم output_config.effort لضبط التفكير.
تحقق من التعامل مع السجل. أعد تشغيل استجابات المساعد الكاملة بترتيبها الأصلي. أبقِ الرسائل السابقة وتعليمات النظام وتعريفات الأدوات كما هي؛ ألحِق الأدوار الجديدة. اختبر أي شيفرة تقوم بقص السجل أو تحديث الأدوات.
حدّث الأدوات الاختيارية معاً. طبّق تغييرات استخدام الحاسوب والمستشار المذكورة أعلاه حيثما لزم. ابدأ محادثة جديدة بعد تغيير تعريفات الأدوات.
اختبر مسار العودة. شغّل مهمة متعددة الأدوار، ودورة أداة، ورجوعاً احتياطياً إلى نموذجك السابق. لا تعني استجابة رجوعٍ احتياطي ناجحة أن التفكير السابق قد نجا.
عند استخدام CometAPI، أكّد إتاحة النموذج والميزات الاختيارية المطلوبة على هذا المسار قبل تفعيلها في الإنتاج. واجهة Messages المتوافقة وحدها لا تثبت دعم كل ميزة لدى المزوّد.
هل الترحيل مجدٍ؟
من Fable 5.1: امنح الأولوية لتجربة تجريبية إذا كانت الأعمال التقنية المعقّدة قيّمة لتطبيقك. تجعل الأسعار القياسية الأقل التجربة جذابة، لكن قارن تكلفة المهام المكتملة بدلاً من افتراض أن كل طلب سيستخدم الرموز نفسها.
من Opus أو Sonnet أو Haiku: ابدأ بالمهام التي يعجز نموذجك الحالي عن إتمامها. قد يزيد نقل كل الطلبات إلى Fable الإنفاق من دون تحسين العمل المباشر. يمكنك إبقاء الطلبات الروتينية على النموذج الحالي وتقييم Fable للحالات الأصعب.
حافظ على إعدادك الحالي الآن إذا كان يحقق أهداف الجودة وزمن الاستجابة، أو إذا كانت تغييرات السجل والأدوات المطلوبة تفوق المنفعة المقاسة. يجب أن يحلّ الترقية مشكلة يمكنك تحديدها.
واجهة Anthropic الرسمية مقابل CometAPI: لماذا اخترت الثانية
تطبيقات تسعى لخفض تكلفة الرموز أو دمج نماذج من عدة مزوّدين
التحقق من الميزات
تحقّق من متطلبات النموذج والحساب لدى Anthropic
تحقّق من متطلبات النموذج والمسار المختار عبر البوابة
أين يبسط CometAPI تطبيقاً متعدد النماذج
توثّق CometAPI طبقة مفتاح وفوترة مشتركة عبر عدة صيغ API. بالنسبة لفريق يحافظ على عدة عمليات تكامل مع نماذج، يمكن لهذا أن يقلل عدد بيانات الاعتماد وسير العمل الحسابي المنفصل المطلوب تشغيله. تتزايد الفائدة عندما يكون Claude جزءاً من منتج أوسع.
يمكنك أيضاً الاحتفاظ بتكامل SDK الخاص بـ Anthropic: يغيّر إعداد العميل أدناه المفتاح وعنوان الأساس بينما يبقى جسم طلب Messages نفسه. للتطبيقات التي تستخدم بالفعل واجهة دردشة متوافقة، تقدّم CometAPI نقطة دخول أخرى؛ اختر الصيغة التي تحافظ على الميزات التي يحتاجها تطبيقك.
ابدأ بـ CometAPI عندما يكون تقليل إنفاق الرموز أولوية، سواء استخدمت Claude وحده أو إلى جانب مزوّدين آخرين. اختبر طلبات ممثّلة بشيفرة العميل الحالية لتأكيد الميزات التي تحتاجها. اختر الوصول المباشر إلى Anthropic عندما تتمحور متطلباتك حول عناصر تحكم حساب خاصة بالمزوّد. لأي مسار، تحقّق من إتمام المهام بنجاح، والاستخدام، والزمن قبل نقل حركة الإنتاج.
كيف تستخدم Claude Fable 5.2 API خطوة بخطوة؟
اختر مسار وصول واحد لطلبك الأول. تشترك أمثلة Python في ملف إعداد صغير، لذا يمكنك لاحقاً اختبار المسار الآخر من دون إعادة كتابة جسم الطلب.
الخطوة 1: إنشاء مفتاح API
للوصول الرسمي، اتبع إعداد مفتاح API لدى Anthropic في Claude Console. استخدم مفتاحاً بنطاق مساحة العمل لهذا الدرس وتأكد من أن الحساب لديه وصول وفوترة مكوّنة. خزّنه باسم ANTHROPIC_API_KEY. المفاتيح غير المرتبطة بمساحة عمل تحتاج أيضاً إلى ترويسة مساحة العمل الموضحة في وثائق مصادقة Anthropic.
لـ CometAPI، أنشئ مفتاحاً في لوحة معلومات API وتأكد من وصول النموذج والرصيد. خزّنه باسم COMETAPI_KEY. لا يمكن لمفتاحٍ من مزوّدٍ ما المصادقة إلى نقطة نهاية المزوّد الآخر.
خزّن المفتاح بأمان. تجنّب وضع بيانات الاعتماد مباشرة في شيفرة التطبيق أو JavaScript على الواجهة الأمامية.
على macOS أو Linux، شغّل التعيين المناسب في الطرفية التي ستُطلق Python:
# Set the variable for the route you chose.
export ANTHROPIC_API_KEY="your_anthropic_api_key"
# Or, for CometAPI:
export COMETAPI_KEY="your_cometapi_api_key"
في Windows PowerShell، استخدم متغير البيئة المقابل:
# Set the variable for the route you chose.
$env:ANTHROPIC_API_KEY = "your_anthropic_api_key"
# Or, for CometAPI:
$env:COMETAPI_KEY = "your_cometapi_api_key"
الخطوة 2: أرسل أول طلب باستخدام cURL
هذه أوامر Bash بديلة. شغّل الأمر الخاص بحسابك المختار لتفحّص استجابة HTTP قبل إدخال Python.
أرسل طلباً نصياً مباشرة إلى Anthropic باستخدام مفتاح API بنطاق مساحة عمل:
تستخدم أمثلة HTTP ترويسات الإصدارات الموثّقة لكل مسار: إصدارات Anthropic API وصيغة Messages لدى CometAPI. تدير SDK هذه الترويسات نيابةً عنك؛ لا تزال القدرات التجريبية الاختيارية بحاجة إلى تحقق خاص بكل مسار.
تعيد نقطة النهاية استجابة بأسلوب Anthropic تتضمن المحتوى والاستخدام وstop_reason.
أنشئ client_config.py في مجلد مشروعك. اختر واحداً فقط من الإعدادين التاليين؛ جميع السكربتات اللاحقة تستورد client وMODEL من هذا الملف.
إعداد CometAPI: احفظ هذا كـ client_config.py عند استخدام حساب CometAPI:
import os
from anthropic import Anthropic
MODEL = "claude-fable-5-2"
client = Anthropic(
api_key=os.environ["COMETAPI_KEY"],
auth_token=None,
base_url="https://api.cometapi.com",
)
الإعداد الرسمي: استخدم هذا الإصدار من client_config.py للوصول المباشر إلى Anthropic:
import os
from anthropic import Anthropic
MODEL = "claude-fable-5-2"
client = Anthropic(
api_key=os.environ["ANTHROPIC_API_KEY"],
auth_token=None,
base_url="https://api.anthropic.com",
)
بالنسبة لـ Messages SDK، لا تحتوي عناوين الأساس هذه على اللاحقة /v1. عند مقارنة المسارين، شغّل جلسات منفصلة بالمفتاح وإعداد العميل المتطابقين بدلاً من تبديل بيانات الاعتماد داخل محادثة حيّة.
الخطوة 4: أرسل طلباً باستخدام Python
احفظ هذا كـ fable52.py بجانب client_config.py. يعمل الطلب مع أي إعداد اخترته:
from client_config import client, MODEL
response = client.messages.create(
model=MODEL,
max_tokens=4096,
messages=[{
"role": "user",
"content": "Explain synchronous and asynchronous Python.",
}],
)
for block in response.content:
if block.type == "text":
print(block.text)
print("Stop reason:", response.stop_reason)
print("Input tokens:", response.usage.input_tokens)
print("Output tokens:", response.usage.output_tokens)
شغّل المثال في الطرفية حيث عيّنت المفتاح:
python fable52.py
يطبع طلب نصي ناجح الإجابة والاستخدام. تحقّق من end_turn قبل اعتبار الاستجابة مكتملة. إذا كان سبب الإيقاف هو max_tokens، فراجع المخرجات الجزئية والميزانية؛ نجاح HTTP لا يعني بحد ذاته أن العمل المطلوب قد انتهى.
كيف تضيف التفكير والبث والصور إلى Claude Fable 5.2؟
أبقِ client_config.py من قسم الإعداد. يستخدم كل سكربت أدناه المسار المختار، لذا يمكنك اختبار ميزات جديدة دون تغيير شيفرة الاتصال الأساسية.
التحكم في جهد التفكير
يستخدم Fable 5.2 تفكيراً تكيفياً دائماً. يمكنك حذف إعداد التفكير أو تعيين نوعه إلى adaptive؛ التفكير المُعطّل وميزانيات رموز التفكير اليدوية غير مدعومة.
يقبل معامل effort القيم low وmedium وhigh وxhigh وmax. ابدأ بالافتراضي high، ولا تغيّره إلا بعد أن تملك خط أساس مفيداً لمهمتك.
احفظ هذا كـ fable52_effort.py وشغّل python fable52_effort.py لتعيين effort صراحةً:
from client_config import client, MODEL
response = client.messages.create(
model=MODEL,
max_tokens=8192,
thinking={"type": "adaptive"},
output_config={"effort": "high"},
messages=[{
"role": "user",
"content": "Identify failure modes in a queue-based worker system.",
}],
)
for block in response.content:
if block.type == "text":
print(block.text)
print("Stop reason:", response.stop_reason)
اترك temperature وtop_p وtop_k خارج الطلب الأولي. كما أن Fable 5.2 يرفض فرض اختيار الأداة؛ لا تنقل أنواع tool_choice any أو tool من تكامل آخر.
البث للتطبيقات التفاعلية
بدلاً من انتظار الاستجابة كاملة، يمكن لتطبيقك عرض النص أثناء توليده.
احفظ هذا كـ fable52_stream.py وشغّل python fable52_stream.py:
from client_config import client, MODEL
with client.messages.stream(
model=MODEL,
max_tokens=8192,
messages=[{
"role": "user",
"content": "Design a fault-tolerant microservice architecture.",
}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
final_message = stream.get_final_message()
print("\nStop reason:", final_message.stop_reason)
print("Usage:", final_message.usage)
قد يكون هناك توقف قبل ظهور النص الأول بينما يقوم النموذج بالتفكير. اعتبر البث مكتملاً فقط بعد أن ينهي المساعد عمله بنجاح؛ النص الجزئي وحده لا يؤكد اكتمال الإجابة.
الحفاظ على سجل محادثة متعدد الأدوار
على عكس واجهة دردشة ذات حالة، يعتمد Messages API القياسي على تطبيقك لتزويد سجل المحادثة.
احفظ هذا كـ fable52_history.py وشغّل python fable52_history.py لإرسال طلبين مرتبطين:
from client_config import client, MODEL
history = [{
"role": "user",
"content": "Design a scalable event-processing architecture.",
}]
first = client.messages.create(
model=MODEL,
max_tokens=8192,
output_config={"effort": "high"},
messages=history,
)
if first.stop_reason != "end_turn":
raise RuntimeError(f"First turn is incomplete: {first.stop_reason}")
history.append({
"role": "assistant",
"content": [block.model_dump() for block in first.content],
})
history.append({
"role": "user",
"content": "Now identify its three highest-risk failure scenarios.",
})
second = client.messages.create(
model=MODEL,
max_tokens=8192,
output_config={"effort": "high"},
messages=history,
)
for block in second.content:
if block.type == "text":
print(block.text)
print("Stop reason:", second.stop_reason)
لاحظ أن المثال يحتفظ بمحتوى المساعد الكامل من الاستجابة الأولى بدلاً من استخراج النص المرئي فقط.
يقوم Fable 5.2 بالتحقق من التفكير مقابل المحادثة السابقة. أبقِ الرسائل السابقة وتعليمات النظام وتعريفات الأدوات دون تغيير عند إعادة تشغيل تلك الكتل. ألحِق الدور التالي بدلاً من إعادة بناء المقدّمة.
توضح رسوم Anthropic حول السياق والضغط لماذا تحتاج جلسة طويلة في النهاية إلى سجل عمل أصغر. يأتي المخطط من Claude Code؛ يجب على تطبيق API مخصص تنفيذ إدارة السياق الخاصة به.
بالنسبة لهذا الدرس، أبقِ السجل القصير كما هو. قبل إضافة الضغط إلى تطبيق أطول، تأكّد من أن بوابتك تدعم الخيار الجانبي على الخادم الموثّق. إذا بدأت محادثة جديدة من ملخّص، فلا تُرفق كتل التفكير الموقّعة من المقدّمة القديمة.
إرسال صورة للتحليل
يضع تنسيق إدخال الصور الأصلي كتلة صورة إلى جانب تعليمات نصية. يقرأ هذا المثال ملف PNG محلياً؛ تحقّق من دعم الصور وحدود الحجم على مسار البوابة الذي اخترته قبل استخدام مدخلات أكبر.
ضع dashboard.png بجانب السكربتات، واحفظ هذا كـ fable52_vision.py، وشغّل python fable52_vision.py:
import base64
from pathlib import Path
from client_config import client, MODEL
image_data = base64.b64encode(
Path("dashboard.png").read_bytes()
).decode("ascii")
response = client.messages.create(
model=MODEL,
max_tokens=4096,
messages=[{
"role": "user",
"content": [
{
"type": "image",
"source": {
"type": "base64",
"media_type": "image/png",
"data": image_data,
},
},
{
"type": "text",
"text": "Identify three usability issues in this dashboard.",
},
],
}],
)
for block in response.content:
if block.type == "text":
print(block.text)
print("Stop reason:", response.stop_reason)
إضافة أدوات يتحكم بها التطبيق
في حلقة أدوات على جانب العميل، عرّف الأدوات بمخططات إدخال، واقرأ كتل tool_use المُعادة، ونفّذ العملية المسموح بها في تطبيقك، وأرسل كتل tool_result المطابقة في رسالة المستخدم التالية. احتفظ باستجابة المساعد الكاملة قبل إعادة تلك النتائج.
ابدأ بأداة للقراءة فقط، مثل البحث عن سجل. تحقّق من صحة الوسائط وتعامل مع tool_use كاستمرارية للمهمة. لا يقوم النموذج الذي يولّد استدعاء أداة بتنفيذ شيفرة تطبيقك بذاته.
كم تكلفة Claude Fable 5.2 API؟
أسعار CometAPI المنشورة أقل بنسبة 20% من الأسعار القياسية لدى Anthropic عبر كل فئات الرموز الخمس أدناه. الأسعار بالدولار الأمريكي لكل مليون رمز؛ قارن الفئة نفسها على كل مسار عند تقدير عبء العمل.
السعر لكل 1M رمز
Anthropic API المباشر
سعر CometAPI المعروض
الإدخال القياسي
$8
$6.4
الإخراج القياسي
$40
$32
كتابة كاش، TTL 5 دقائق
$10
$8
كتابة كاش، TTL ساعة
$16
$12.8
قراءة كاش
$0.20
$0.16
تم التحقق من الأسعار في 10 نوفمبر 2026. تستخدم هذه المقارنة الأسعار القياسية المنشورة لـ API، قبل أي اتفاقيات خاصة بالحساب أو رسوم أدوات إضافية.
تقدير طلب بلا كاش
لـ 100,000 رمز إدخال و10,000 رمز إخراج من دون تخزين مؤقت، تبلغ تكلفة CometAPI تقديرياً (0.1 × $6.40) + (0.01 × $32) = $0.96. أما الاستخدام نفسه بأسعار Anthropic القياسية فيكلف (0.1 × $8) + (0.01 × $40) = $1.20. ستوفر $0.24 لكل طلب، أي 20%، قبل أي رسوم أدوات إضافية.
عند 1,000 طلب بهذا الاستخدام للرموز، ينخفض إنفاق الرموز المقدر من $1,200 إلى $960، تاركاً $240 لتشغيلات إضافية أو أعباء عمل نماذج أخرى. لميزانية إنتاج، استخدم أعداد الرموز المفوترة فعلياً وضمّن عمليات إعادة المحاولة، وعمليات الكاش، والأدوات المفوترة بشكل منفصل.
يوفر دليل الرجوع إلى نموذج/مزوّد بديل لدى CometAPI خطوة تالية مفيدة: يمكن لنموذج ثانوي متوافق استخدام مفتاح CometAPI وعنوان الأساس نفسيهما، مع مسار رسمي مكوَّن بشكل منفصل إذا احتجته. يجب أن يطبق تطبيقك السياسة؛ معرّفات النماذج وحدها لا توحّد صيغ المحتوى ولا تضمن استرداداً ناجحاً.
قيود Claude Fable 5.2
على الرغم من قدراته المتقدمة، لدى Fable 5.2 عدة قيود عملية:
تكلفة رموز أعلى: عند $8 لكل مليون رمز إدخال و$40 لكل مليون رمز إخراج، فهو أغلى بكثير من Opus 5.5.
كمون متوسط: قدراته المتقدمة في التفكير والأفق الطويل لا تجعله الخيار الأفضل للتطبيقات الحساسة للكمون.
لا يمكن تعطيل التفكير التكيفي: يجب على المطورين إدارة عمق التفكير عبر إعدادات effort.
قيود في مهام الأمن السيبراني والبيولوجيا: يضم Fable مصنّفات أمان تحجب بعض طلبات الأبحاث السيبرانية والبيولوجية عالية المخاطر.
قيود معلمات API: يؤدي فرض اختيار الأداة باستخدام tool_choice بالقيم any وtool إلى خطأ 400. ويُستحسن حذف معلمات العيّنة مثل temperature وtop_p وtop_k.
متطلبات الاحتفاظ بالبيانات: توضح وثائق نموذج Anthropic احتفاظاً بالبيانات لمدة 30 يوماً لـ Fable 5.2 ما لم يُصرَّح باستثناء صريح.
فحوصات إعداد شائعة
العَرَض
الإجراء الأول
401 أو 403
تحقق من أن المفتاح يعود لنقطة النهاية المختارة ولديه وصول إلى النموذج.
نموذج غير معروف أو 404
تحقق من عنوان الأساس ومعرّف النموذج الدقيق.
400 طلب غير صالح
افحص جسم الخطأ لحقول غير مدعومة أو مقدّمة محفوظة غير صالحة.
سبب الإيقاف max_tokens
راجع الإجابة الجزئية وميزانية الإخراج قبل بدء طلب آخر.
لإخفاق غير متوقع، سجّل الوقت، ومعرّف النموذج، والحالة، ومعرّف الطلب عند توفره. أبقِ مفاتيح API ونصوص المطالبة الحساسة خارج السجلات الروتينية.
الأسئلة الشائعة
كيف أحصل على وصول إلى Claude Fable 5.2 API؟
اختر الوصول المباشر إلى Anthropic أو CometAPI، وأنشئ مفتاح API لذلك المزوّد، واضبط الفوترة أو الرصيد. أرسل أول طلب Messages مع النموذج claude-fable-5-2. نقاط النهاية المستخدمة في هذا الدليل هي https://api.anthropic.com/v1/messages وhttps://api.cometapi.com/v1/messages. استخدم المفتاح الصادر من المزوّد الذي تتصل به؛ المفاتيح غير قابلة للتبادل. اتبع قسم الإعداد أعلاه ووثائق Messages لدى CometAPI لمسار البوابة.
كم تكلفة Claude Fable 5.2 API؟
تسعير Anthropic القياسي هو $8 لكل مليون رمز إدخال و$40 لكل مليون رمز إخراج. تعرض CometAPI $6.40 و$32، على التوالي، كما في 11 نوفمبر 2026. عند هذه الأسعار، تكلف 100,000 رمز إدخال و10,000 رمز إخراج $1.20 مباشرة أو $0.96 عبر CometAPI، من دون تخزين مؤقت أو رسوم إضافية. لعمليات الكاش والأوضاع الاختيارية أسعار منفصلة.
هل يمكنني استخدام Anthropic Python SDK مع CometAPI؟
نعم. توثّق CometAPI نقطة نهاية Messages متوافقة مع Anthropic. اضبط عميل Anthropic بمفتاح CometAPI وbase_url="https://api.cometapi.com"، ثم استخدم client.messages.create. لا يحتوي عنوان الأساس في هذا الدليل على اللاحقة /v1. أبقِ معرّف النموذج مضبوطاً على claude-fable-5-2 وتحقق من أي ميزة اختيارية على المسار المحدد قبل الاعتماد عليها.
هل يمكنني تعطيل التفكير في Claude Fable 5.2 API؟
لا. يستخدم Fable 5.2 تفكيراً تكيفياً دائماً. تحكّم بعمق التفكير عبر output_config.effort؛ القيمة الافتراضية في API هي high. لا ترسل تفكيراً معطّلاً أو إعداد budget_tokens يدوياً. يشرح دليل الترحيل الإعدادات المدعومة. اختبر جهداً أقل على مهام ممثلة إذا رغبت في خفض تكلفة التفكير أو الكمون.
هل يدعم Claude Fable 5.2 إدخال الصور ونافذة سياق 1M token؟
نعم. تُدرج مواصفات النموذج إدخال نص وصور، وإخراج نصي، ونافذة سياق 1M token، وحتى 128K رمز إخراج. يتيح إدخال الصور تحليل صورة موجودة؛ لا يجعل النموذج مولّداً للصور. أكد حدود حجم الطلب على المسار الذي اخترته قبل إرسال حمولة كبيرة.
هل يمكنني الترحيل من Fable 5.1 بتغيير معرّف النموذج فقط؟
قد يحتاج طلب نصي جديد بسيط إلى تغيير النموذج فقط، لكن تكامل إنتاج يحتاج إلى مزيد من الفحوصات. يعرّف دليل الترحيل الرسمي تغييرات على التحقق من مقدّمة المحادثة، وتوافق كتل التفكير، واستخدام الحاسوب، واختيار المستشار. اتبع قسم الترحيل أعلاه، خاصة إذا كان تطبيقك يحرر السجل، أو يبدّل النماذج في منتصف المحادثة، أو يستخدم هذه الأدوات.
لماذا يعيد طلبي إلى Claude Fable 5.2 API خطأ 400؟
اقرأ رسالة الخطأ في الاستجابة أولاً. تشمل الأسباب الشائعة إعدادات تفكير غير مدعومة، أو Prefills للمساعد، أو فرض اختيار الأداة، أو إعادة تشغيل كتل التفكير بعد تغيير المحادثة السابقة. يصف دليل الترحيل لدى Anthropic هذه القيود. أعِد إنتاج المشكلة بطلب بسيط جديد، ثم أضف خياراتك وسجلك تدريجياً. إعادة محاولة الطلب غير الصالح نفسه لن تصلحه.
كيف أتعامل مع حدود معدل Claude Fable 5.2 API؟
خفّض الطلبات المتزامنة واتبع Retry-After عندما تعيده البوابة. يتيح لك إعداد إعادة المحاولة في Python SDK تحديد حد أقصى لإعادات المحاولة التلقائية؛ فهو يعيد المحاولة بالفعل في بعض الإخفاقات المؤقتة، بما في ذلك استجابات 429. تجنّب تكديس حلقة إعادة محاولة غير محدودة في التطبيق فوق ذلك. إذا استمرت الإخفاقات، تحقق من حصة حساب المسار الذي اخترته ورصيده بدلاً من زيادة عدد الإعادات.
الخلاصة
اختر مساراً، واحفظ إعداد عميله، وشغّل المثال النصي حتى يمكنك شرح سبب الإيقاف والاستخدام المُعادين. بعدها، تحقق من قدرة إضافية واحدة في كل مرة باستخدام مدخلات ستتلقاها منتجياً بالفعل.
شغّل تجربة إنتاجية صغيرة عبر CometAPI وقارن رسوم الرموز المسجلة بالتقدير أعلاه. إذا كان مخططك يشمل مزوّدين آخرين، أضف نموذجاً ثانياً لاختبار سير الوصول والفوترة المشتركة. أبقِ الوصول المباشر إلى Anthropic متاحاً عندما يتطلب الأمر ميزة أصلية، ووسّع الإعداد الذي يحقق أهداف الجودة والميزانية لديك.
