Claude Sonnet 5 API: بدء سريع في دقائق
ما تحتاجه لاستدعاء claude-sonnet-5 من Messages API - معرّف النموذج، وأمثلة curl وPython، وeffort، والتفكير التكيفي، وإعادة ضبط max_tokens. اعتبارًا من 2026-10-20، لا يزال أحدث Sonnet هو Sonnet 5.5 (صدر في 2026-09-28، بسعر $2 / $10، وقراءات التخزين المؤقت $0.10 — بينما Sonnet 5 هو $0.20)؛ أُهمل Sonnet 4.5 في 2026-09-30 ويتقاعد في 2026-11-30، مع claude-sonnet-5-5 كبديل موصى به.
بدء سريع
Sonnet 5 بديل مباشر على Messages API القياسي. إذا كنت تستدعي Opus 4.8 أو Sonnet 4.6 بالفعل، فأنت على بُعد ثلاث خطوات صغيرة. إذا كنت لا تزال على Sonnet 4.5، فاعلم أن claude-sonnet-4-5-20250929 يتقاعد في 2026-11-30؛ والبديل هو claude-sonnet-5-5.
عيّن معرّف النموذج
استخدم claude-sonnet-5 — لقطة مثبتة بلا تاريخ وبلا لاحقة -v1. ولا يلزم أي تغيير آخر لطلب أساسي.
أزل معاملات أخذ العينات
أزل temperature، وtop_p، وtop_k. يرفضها Sonnet 5 بخطأ HTTP 400، تمامًا مثل Opus 4.7 والإصدارات اللاحقة.
أبقِ التفكير تكيفيًا
التفكير التكيفي مفعّل افتراضيًا. لا ترسل إعدادات extended-thinking يدوية — فالتفكير الصريح يعيد 400. واضبط العمق باستخدام effort بدلًا من ذلك.
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 4096,
"thinking": { "type": "adaptive" },
"output_config": { "effort": "high" },
"messages": [
{ "role": "user", "content": "Refactor this module and add tests." }
]
}'
# NOTE: do NOT send temperature / top_p / top_k -> HTTP 400
from anthropic import Anthropic
client = Anthropic() # reads ANTHROPIC_API_KEY
resp = client.messages.create(
model="claude-sonnet-5",
max_tokens=4096,
thinking={"type": "adaptive"}, # on by default
output_config={"effort": "high"}, # low | medium | high | xhigh | max
messages=[
{"role": "user", "content": "Explain this stack trace and propose a fix."}
],
# temperature / top_p / top_k omitted -> sending them returns HTTP 400
)
print(resp.content[0].text)
يحذف كلا المثالين temperature، وtop_p، وtop_k عمدًا: إرسال أي منها إلى claude-sonnet-5 يعيد HTTP 400. التفكير التكيفي (thinking={"type":"adaptive"}) هو الافتراضي، ويتحكم حقل effort في مقدار الاستدلال الذي يستهلكه النموذج لكل طلب.
أعد ضبط max_tokens
يتضمن Sonnet 5 مُجزّئ tokens جديدًا. يستهلك النص نفسه عددًا من tokens يزيد بنحو 30% مقارنة بـ Sonnet 4.6، لذا فإن الحدود والميزانيات المنسوخة من تعليمات برمجية أقدم ستُسبب مشكلات.
ارفع الحد الأقصى للإخراج
قد تؤدي قيمة max_tokens التي كانت تناسب استجابة Sonnet 4.6 بأريحية إلى اقتطاع الاستجابة الآن. امنح هامشًا إضافيًا بنحو 30%، حتى سقف الإخراج البالغ 128K (و300K عبر ترويسة beta للدفعات output-300k-2026-03-24).
أعد التحقق من ميزانيات السياق
نافذة السياق هي 1M tokens - سواء الافتراضية أو القصوى، دون نسخة أصغر - لكن الـ prompts التي حُدد حجمها بالـ tokens ستُحزم بكثافة أكبر، لذا أعد القياس باستخدام عدّ الـ tokens بدلًا من الافتراض.
أعد تقدير التكلفة لكل طلب
ولأن النص نفسه يحتوي على tokens أكثر بنحو 30%، فمن الأفضل قراءة سعر $2/MTok للإدخال + $10/MTok للإخراج على أنه محايد من حيث التكلفة تقريبًا مقابل $3/$15 الخاصة بـ Sonnet 4.6 على النص نفسه - وليس خصمًا ثابتًا بنسبة 33%.
الأسعار القياسية هي $2/MTok للإدخال + $10/MTok للإخراج، وقد تأكد اعتمادها سعرًا طويل الأجل في 2026-08-10 بعد إلغاء الزيادة في 2026-09-01. قراءات التخزين المؤقت هي $0.20، وكتابة التخزين المؤقت لمدة 5 دقائق تعادل 1.25x من الإدخال الأساسي، وكتابة التخزين المؤقت لمدة 1 ساعة تعادل 2x من الإدخال الأساسي. سعر Sonnet 5.5 (صدر في 2026-09-28) هو نفسه سعر Sonnet 5، مع خفض قراءات التخزين المؤقت إلى النصف لتبلغ $0.10؛ وتكتب Anthropic أنه يحتاج عادةً إلى tokens أقل للعمل نفسه، وتقل تكلفته بما يصل إلى 30% لكل مهمة. كما انتقل Haiku 5.5 (صدر في 2026-10-07) أيضًا إلى مُجزّئ tokens محدث، تصفه Anthropic بأنه مشابه لذلك المستخدم في Sonnet 5.5 وOpus 5.5. اضبط دائمًا حجم max_tokens وفق مُجزّئ الـ tokens الجديد، لا وفق أعدادك القديمة.
مستويات effort
يضبط معامل effort مقدار الاستدلال الذي يصرفه Sonnet 5 في كل طلب. يقبل خمسة مستويات؛ والافتراضي هو high.
| effort | الأفضل لـ | زمن الاستجابة وtokens الإخراج |
|---|---|---|
| low | التصنيف والاستخراج والدردشة القصيرة وغيرها من الطلبات الحساسة لزمن الاستجابة والمحددة النطاق جيدًا. | أدنى زمن استجابة، وأقل عدد من tokens الاستدلال. |
| medium | المساعدة اليومية والبرمجة الأخف حيث تريد قدرًا أكبر قليلًا من التروّي دون العمق الكامل. | زمن استجابة متوسط وإنفاق tokens متوسط. |
| high الافتراضي | معظم أعمال الوكلاء والبرمجة - الخيار الافتراضي المتوازن الذي يجمع بين السرعة والاستدلال القوي. | متوازن؛ نقطة البداية الموصى بها. |
| xhigh | تصحيح الأخطاء الصعب متعدد الخطوات، والتصميم المعماري، وتشغيلات الوكلاء طويلة الأفق التي تكافئ التفكير الأعمق. | زمن استجابة أعلى، وtokens استدلال أكثر. |
| max | مهام الاستدلال والحكم الأكثر تطلبًا حيث تريد أقصى عمق بغض النظر عن التكلفة. | أعلى زمن استجابة وأعلى إنفاق tokens. |
ابدأ بـ high، واخفض المستوى للحركة الرخيصة والحساسة لزمن الاستجابة، وارفع المستوى لأصعب المشكلات. يقترب Sonnet 5 من فئة Opus آنذاك بسعر أقل. اعتبارًا من 2026-10-20، أحدث Opus هو Opus 5.5 (صدر في 2026-09-22، $4 / $20)، وتضعه Anthropic لأعمال معقدة تحتاج إلى حكم متأنٍ - والجأ إليه عندما لا يزال أقصى effort غير كافٍ. وتقول النظرة العامة الرسمية للنماذج الآن: ابدأ بـ Opus 5.5 لمعظم أحمال العمل، واستخدم Fable 5.1 للاستدلال المتطلب والأعمال الوكيلية طويلة الأفق.
استخدام Sonnet 5 عبر QCode
تقدم QCode خدمة ترحيل لنفس Messages API، لذا يبقى كود Sonnet 5 لديك دون تغيير - لا يختلف سوى Base URL والمفتاح.
واجهة API متطابقة
نفس معرّف النموذج claude-sonnet-5، ونفس معامل effort، ونفس التفكير التكيفي. وجّه SDK إلى Base URL الخاص بخدمة الترحيل وسيعمل كودك الحالي مباشرة.
مفتاح واحد، نماذج متعددة
مفتاح QCode واحد يصل إلى Claude وCodex والنماذج الصينية - دون عناء إدارة حسابات مزوّدين منفصلة أو فوترة منفصلة.
وصول مستقر من الصين
لحركة المرور من الصين القارية، فضّل عقدة آسيا asia.qcode.cc (الأقرب بين كوريا وتايوان وهونغ كونغ)؛ ويستخدم النطاق الأساسي api.qcode.cc توجيهًا عالميًا. وكلاهما يوفر زمن استجابة منخفضًا ووصولًا ثابتًا، لذا لم يعد على Sonnet 5 أن يصارع الاتصال العابر للحدود.
جاهز للاستخدام مباشرة مع الأدوات
يعمل مع anthropic SDK وClaude Code وأي عميل يتوافق مع Messages API - اضبط Base URL وانطلق.
from anthropic import Anthropic
client = Anthropic(
base_url="https://api.qcode.cc/api", # QCode
api_key="cr_...", # your QCode API key
)
resp = client.messages.create(
model="claude-sonnet-5",
max_tokens=4096,
thinking={"type": "adaptive"},
output_config={"effort": "high"},
messages=[{"role": "user", "content": "Ship it."}],
)
الأسئلة الشائعة
ما معرّف نموذج Claude Sonnet 5؟
معرّف النموذج هو claude-sonnet-5 - لقطة مثبتة بلا تاريخ ودون لاحقة -v1. على Amazon Bedrock يكون anthropic.claude-sonnet-5، وعلى OpenRouter يكون المعرّف النصي هو anthropic/claude-sonnet-5-20260630. مرّر claude-sonnet-5 في حقل model لأي طلب Messages API. إذا كنت لا تزال على Sonnet 4.5: أعلنت Anthropic إهمال claude-sonnet-4-5-20250929 في 2026-09-30، وستوقفه في 2026-11-30، وتسمّي claude-sonnet-5-5 كبديل موصى به؛ أما claude-sonnet-5 نفسه فلا يزال متاحًا ولن يتم إيقافه قبل 2027-06-30.
هل أحتاج إلى تغيير الكود الخاص بي لاستدعاء Sonnet 5؟
في الغالب لا - غيّر معرّف النموذج إلى claude-sonnet-5 وسيستمر كود Messages API الحالي لديك في العمل. هناك أمران يجب التحقق منهما: أزل أي حقول temperature أو top_p أو top_k (فهي تعيد HTTP 400 على Sonnet 5، كما هو الحال مع Opus 4.7+)، ولا ترسل إعداد extended-thinking يدويًا - فالتفكير التكيفي مفعّل افتراضيًا، وإعداد thinking الصريح يعيد 400. أعد أيضًا ضبط max_tokens، لأن مُجزّئ الـ tokens الجديد يُنتج tokens أكثر بنحو 30% للنص نفسه.
أي مستوى effort يجب أن أستخدم مع Sonnet 5؟
القيمة الافتراضية هي high، وهي تناسب معظم أعمال الوكلاء والبرمجة. استخدم low أو medium للطلبات الرخيصة والحساسة لزمن الاستجابة مثل التصنيف والاستخراج والدردشة القصيرة، وxhigh أو max لأصعب الاستدلالات متعددة الخطوات حيث تريد أقصى عمق. يقايض effort زمن الاستجابة وtokens الإخراج مقابل عمق الاستدلال، لذا ابدأ بـ high واضبط حسب عبء العمل.
هل يمكنني استخدام Claude Sonnet 5 عبر QCode؟
نعم. يتيح QCode نفس واجهة Messages API عبر خدمة الترحيل الخاصة به، لذا تحتفظ بمعرّف النموذج claude-sonnet-5 ومعامل effort والتفكير التكيفي دون تغيير - لا يختلف سوى Base URL والمفتاح. أصبح claude-sonnet-5-5 متاحًا على QCode منذ 2026-09-29، إلى جانب claude-sonnet-5 وclaude-opus-5-5.
ابدأ البناء باستخدام Claude Sonnet 5
احصل على مفتاح واحد لـ Claude وCodex والنماذج الصينية - مع وصول مستقر ونفس Messages API الذي تستخدمه بالفعل.
أدلة ذات صلة
نظرة عامة على Claude Sonnet 5
الموجز الكامل عن النموذج: التموضع، ونافذة السياق، والتوافر، ومكانة Sonnet 5 في التشكيلة.
Sonnet 5 مقابل Sonnet 4.6
ما الذي تغيّر - أداة تقطيع token والتسعير والجهد والجودة - ولماذا لم يتم إيقاف Sonnet 4.6.
أسعار Claude Sonnet 5
الأسعار التمهيدية مقابل الأسعار القياسية، وتكاليف التخزين المؤقت، والملاحظة التحذيرية المتعلقة بأداة تقطيع token التي تشكّل الإنفاق الفعلي لكل طلب.
تحسين تكلفة Claude Code
تكتيكات عملية - ضبط الجهد والتخزين المؤقت واختيار النموذج - لإبقاء نفقات البرمجة بالوكلاء تحت السيطرة.