Claude Sonnet 5.5

مرجع Messages لنموذج Claude Sonnet 5.5: المعاملات الرسمية، والتفكير التكيفي وبين استدعاءات الأدوات، واستخدام ذاكرة التخزين المؤقت، وحقول الاستجابة، وحدود التوافق المختبَرة.

استخدم claude-sonnet-5-5 بصيغة Anthropic Messages. يميّز هذا المستند بين المواصفات الرسمية للطلبات والسلوك الذي لوحظ في اختبارات التوافق. بعض الخيارات المتقدمة لا تعمل وفق المواصفات حتى الآن؛ راجع القيود قبل الاعتماد عليها.

راجع صفحة النموذج للاطلاع على الأسعار الحالية للمدخلات والمخرجات وذاكرة التخزين المؤقت.

البدء السريع

curl https://api.seedrouter.ai/v1/messages \
  -H "x-api-key: $SEEDROUTER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Explain how a rainbow forms in three sentences."}]
  }'

يقبل POST /v1/messages المصادقة عبر x-api-key أو Bearer، إلى جانب anthropic-version: 2023-06-01. أرسل ترويسة anthropic-beta للميزات التي تتطلبها وثائقها الرسمية. احتفظ ببيانات الاعتماد في الشيفرة التي تعمل على الخادم.

يقبل النموذج أيضًا طلبات OpenAI Chat Completions (POST /v1/chat/completions) وResponses (POST /v1/responses) الأساسية. استخدم Messages للمعاملات الأصلية الموضحة أدناه؛ فتحويل صيغة OpenAI لا يوفّر جميع ميزات Anthropic.

المواصفات الرسمية للمعاملات

يملك Sonnet 5.5 نافذة سياق بسعة 1M توكن، وحدًا للمخرجات المتزامنة يبلغ 128000 توكن. لا تنطبق حدود المخرجات الخاصة بالمعالجة على دفعات على نقطة النهاية هذه. لا يعيّن التطبيق قيمًا افتراضية للخصائص الاختيارية ما لم يذكر الجدول خلاف ذلك.

المعامل	النوع / الإلزام	القيود والقيم الافتراضية الرسمية
`model`	سلسلة نصية، مطلوب	`claude-sonnet-5-5`.
`max_tokens`	عدد صحيح، مطلوب	0–128000، بما فيها توكنات التفكير. وفق المواصفات الرسمية، تملأ القيمة 0 ذاكرة التخزين المؤقت للموجهات دون توليد مخرجات؛ راجع القيد الحالي أدناه.
`messages`	مصفوفة كائنات، مطلوب	رسالة محادثة واحدة على الأقل، وبحد أقصى 100000. تحتوي كل رسالة على `role` و`content`؛ والمحتوى سلسلة نصية أو مصفوفة كتل محتوى. تستخدم الأدوار العادية `user`/`assistant`. تخضع رسائل `system` في وسط المحادثة للقواعد الرسمية الخاصة بمواضعها.
`system`	سلسلة نصية أو مصفوفة كتل نصية	تعليمات على المستوى الأعلى. يمكن أن تتضمن الكتل النصية نقاطًا فاصلة للتخزين المؤقت.
`thinking`	كائن	الافتراضي: `{"type":"adaptive"}`. الوضع الآخر المدعوم هو `{"type":"between_tools"}`. تُرفض الميزانيات اليدوية و`disabled`.
`thinking.display`	قيمة تعدادية	في الوضع التكيفي فقط: `omitted` (الافتراضي) أو `summarized`. حذف الملخص لا يعني تعطيل التفكير.
`thinking.block_binding`	كائن، تجريبي	في الوضع التكيفي فقط. يتطلب `thinking-binding-controls-2026-08-01`؛ اتبع المواصفات الرسمية للاحتفاظ بالتفكير.
`output_config.effort`	قيمة تعدادية أو null	`low`، `medium`، `high`، `xhigh`، `max`؛ والافتراضي `high`. تُبقي null القيمة الافتراضية سارية.
`output_config.format`	كائن أو null	مخرجات JSON منظمة: `{"type":"json_schema","schema":{...}}`. استخدم المجموعة الفرعية المدعومة من JSON Schema.
`stream`	قيمة منطقية	الافتراضي `false`؛ وتُعيد `true` أحداث SSE.
`stop_sequences`	مصفوفة سلاسل نصية	وفق المواصفات الرسمية، يتوقف التوليد عند سلسلة مطابقة. لم يُطبَّق هذا السلوك في اختبار التوافق الحالي.
`temperature`	عدد أو null	تُقبل القيمة 1 فقط لأغراض التوافق؛ احذف هذا المعامل. تُرفض القيم الأخرى غير null.
`top_p`	عدد أو null	تُقبل القيم 0.99–1 فقط لأغراض التوافق؛ احذف هذا المعامل.
`top_k`	لا تُقبل أي قيمة غير null	أخذ العينات غير مدعوم؛ احذف هذه الخاصية.
`tools`	مصفوفة كائنات	تتضمن أدوات العميل `name` و`input_schema` وإعدادات اختيارية للوصف / الوضع الصارم. تستخدم أدوات الخادم تعريفاتها الرسمية المحددة بالإصدار.
`tool_choice`	كائن	`auto` (الافتراضي) أو `none`. تُرفض `any` وفرض أداة مسماة باستخدام `tool`. قد تتضمن `auto` الخاصية `disable_parallel_tool_use`.
`metadata.user_id`	سلسلة نصية أو null	بحد أقصى 512 حرفًا؛ استخدم معرّفًا معتمًا.
`cache_control`	كائن أو null	`type: "ephemeral"`؛ و`ttl: "5m"` (الافتراضي) أو `"1h"`. يتطلب Sonnet 5.5 ما لا يقل عن 512 توكن قابلة للتخزين المؤقت. تدعم الواجهة الرسمية أيضًا النقاط الفاصلة للتخزين المؤقت على مستوى الكتل.
`diagnostics`	كائن أو null	`previous_message_id`: سلسلة نصية بحد أقصى 256 حرفًا أو null. يطلب تشخيص الاختلافات في ذاكرة التخزين المؤقت.
`service_tier`	قيمة تعدادية	`auto` (الافتراضي) أو `standard_only`.
`speed`	قيمة تعدادية أو null	احذفه أو استخدم `standard` / null. لا يدعم Sonnet 5.5 الوضع `fast`.
`inference_geo`	سلسلة نصية أو null	تأتي القيمة الافتراضية الرسمية من إعدادات الحساب. قبول الطلب وحده لا يؤكد الموقع الجغرافي للمعالجة.
`fallbacks`	سلسلة نصية أو مصفوفة كائنات أو null، تجريبي	`"default"` أو ثلاثة إدخالات بديلة كحد أقصى. يتطلب كل إدخال `model`؛ ويمكن تجاوز القيم اختياريًا عبر `max_tokens` و`thinking` و`output_config` و`speed`. راجع قواعد التحويل إلى النماذج البديلة أدناه.
`fallback_credit_token`	سلسلة نصية أو كائن أو null	رمز من رفض سابق، أو `{"token":"...","mode":"strict"}`. تتطلب صيغة الكائن `fallback-credit-2026-07-01`؛ والوضع هو `strict` (الافتراضي) أو `best_effort`. لا يمكن استخدامه مع قيمة `fallbacks` غير null.
`container`	سلسلة نصية أو كائن أو null	معرّف الحاوية، أو إعداداتها مع `id` و`skills` اختياريتين (بحد أقصى 20). تستخدم المهارات الحقول الرسمية للنوع والمعرّف والإصدار.
`context_management`	كائن أو null	إعدادات تحرير السياق الرسمية، بما فيها `edits`؛ وتتجاهل null هذا الإعداد. تظل قواعد توافق التحرير الخاصة بالنموذج سارية.
`mcp_servers`	مصفوفة كائنات	تعريفات خوادم MCP الرسمية، مع الالتزام بالإصدار التجريبي المطلوب ومصادقة الخادم. الاختبار بمصفوفة فارغة لا يؤكد تنفيذ MCP عن بُعد.
`compaction`	كائن أو null، تجريبي	`{"type":"summarize"}`، مع `compact-2026-09-04`؛ وتتجاهل null ضغط السياق. عند تفعيل ضغط السياق، لا يمكن جمعه مع `context_management` غير null أو تسلسلات الإيقاف أو صيغة المخرجات المنظمة. لم يجتز سلوك ضغط السياق الموقّع الاختبار الحالي.
`messages[].output_config.effort`	قيمة تعدادية، تجريبي	مستوى الجهد لكل رسالة، ويُضبط في رسالة نظام؛ يتطلب `mid-conversation-output-config-2026-07-01`. يمكن أن تظهر رسائل النظام التي تحتوي على مستوى الجهد فقط في أي موضع؛ أما مجموعات رسائل النظام التي تتضمن محتوى فتخضع للقواعد الرسمية الخاصة بمواضعها. لا يجوز أن يغيّر هذا الإعداد مستوى الجهد في وضع `between_tools`.

لا يقبل between_tools سوى الخاصية type ومستوى الجهد low أو medium أو high. لا ترسل معه display أو budget_tokens أو block_binding. مثال:

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "thinking": {"type": "between_tools"},
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Explain this concept briefly."}]
}

الملء المسبق لمحتوى المساعد غير مدعوم. لمتابعة pause_turn، أعد إرسال محتوى المساعد المُعاد والمرتبط بأدوات الخادم دون تغيير. يلخّص ضغط السياق السجل الحالي، ولا يُعدّ ملئًا مسبقًا لمحتوى المساعد. احتفظ بكتل التفكير والتوقيعات كما هي تمامًا؛ ولا تنقلها بين النماذج أو تعدّل السجل السابق دون اتباع قواعد الربط الرسمية.

في واجهة Claude الأصلية، يتطلب استخدام الكمبيوتر computer_toolset_20260801؛ وتُرفض computer_20251124. تُرفض أيضًا إعدادات المستشار التي تستخدم claude-opus-4-8 أو claude-opus-4-7 أو claude-sonnet-5 لهذا النموذج المنفّذ.

حقول طلبات النماذج البديلة

تعيد ميزة fallbacks التجريبية الرسمية المحاولة في حالات الرفض المؤهلة الصادرة عن المصنّف. لا تعيد المحاولة عند تجاوز حدود المعدل أو زيادة الحمل أو أخطاء الخادم، وقد يستمر الرفض دون حل. أرسل server-side-fallback-2026-07-01 مع "default" أو قائمة صريحة؛ ويدعم server-side-fallback-2026-06-01 القائمة فقط. تُرفض الإصدارات المؤرخة الأخرى.

تحتوي القائمة الصريحة على ثلاثة إدخالات كحد أقصى لنماذج مختلفة، ولا يجوز أن يطابق أيّ منها النموذج المطلوب. تُحدَّد النماذج المستهدفة المسموح بها عبر allowed_fallback_models في واجهة Models التجريبية. يُسمح في كل إدخال فقط بـmodel وmax_tokens وthinking وoutput_config وspeed؛ ويجب أن تكون القيم المتجاوزة صالحة للنموذج المستهدف. يحوّل الإصدار التجريبي لشهر يوليو وضع between_tools في Sonnet 5.5 إلى disabled في Sonnet 5، مع حذف العرض، عند حدوث هذا التحويل إلى النموذج البديل. مع الإصدار التجريبي لشهر يونيو، قدّم بنفسك قيمة تجاوز إعداد التفكير في Sonnet 5.

يُستخدم fallback_credit_token لإعادة محاولة منفصلة بعد الرفض. تختار السلسلة النصية استخدام الرصيد بالوضع الصارم؛ ويضيف الكائن mode. في وضع strict، يؤدي فشل استخدام الرصيد إلى رفض إعادة المحاولة. في وضع best_effort، قد يسمح فشل في طبقة الرمز بالمتابعة بالسعر المعتاد، ويُسجَّل في usage.fallback_credit؛ أما الرموز ذات الصيغة غير الصحيحة والجمع بين الرصيد وfallbacks فلا يزالان يؤديان إلى الفشل. يتطلب استخدام الرصيد أيضًا استيفاء شروط الطلب والحساب ومساحة العمل والمنصة والمهلة البالغة خمس دقائق، كما هو موضح في دليل الرصيد الرسمي.

أعاد طلب ذو محتوى غير ضار، مع fallbacks: "default" وترويسة الإصدار التجريبي لشهر يوليو وspeed: "standard"، النص المتوقع. يؤكد ذلك قبول الطلب فقط: لم يُتحقَّق هنا من التنفيذ عبر نموذج بديل ولا من استخدام الرصيد من البداية إلى النهاية.

مدخلات الوسائط والأدوات

تستخدم الصور كتل image، وتستخدم ملفات PDF كتل document في رسالة مستخدم. تشمل أنواع المصادر الرسمية روابط URL عامة وbase64 مع نوع MIME المناسب. استخدمت اختبارات التوافق صورة PNG بصيغة base64 وملف PDF من صفحة واحدة بصيغة base64، وتحققت من محتوى الإجابات. لم تختبر جميع الحالات الحدّية المتعلقة بروابط URL أو حجم الملفات أو دقة الصور أو عدد صفحات PDF.

تستخدم الأدوات من جانب العميل التبادل القياسي tool_use → tool_result. احتفظ بمعرّفات استخدام الأدوات دون تغيير، وأعِد النتيجة في رسالة مستخدم. نجاح مثال لأداة في الوضع الصارم يؤكد صحة وسائط ذلك المثال، لا جميع الكلمات المفتاحية المدعومة في JSON Schema.

الاستجابات

تحتوي الاستجابة غير المتدفقة على id وtype: "message" وrole: "assistant" وmodel وcontent وstop_reason وstop_sequence وusage، إلى جانب حقول رسمية اختيارية مثل container وdiagnostics وcontext_management وstop_details وحقول الاستجابة التجريبية. قد يتضمن المحتوى نصًا أو تفكيرًا أو استدعاءات أدوات أو نتائج أدوات أو أنواع كتل رسمية أخرى؛ لا تفترض أن الكتلة الأولى نصية.

عند البث المتدفق، تعامل مع message_start وcontent_block_start وcontent_block_delta وcontent_block_stop وmessage_delta وmessage_stop. قد تحدث أخطاء داخل التدفق أيضًا. قد يشمل الاستخدام توكنات الإدخال/الإخراج العادية، وتفاصيل توكنات التفكير، وقراءات ذاكرة التخزين المؤقت، وأعدادًا منفصلة لإنشاء ذاكرة التخزين المؤقت لمدة 5 دقائق / 1 ساعة.

الرفض الرسمي الصادر عن المصنّف هو استجابة عادية تتضمن stop_reason: "refusal" وstop_details، وليس خطأ HTTP. في استجابة النموذج البديل، يحدد model النموذج الذي أجاب، وتشير كتل المحتوى fallback إلى الانتقالات، ويصف usage.iterations المحاولات. افحص هذه الحقول بدلًا من افتراض أن النموذج المطلوب هو الذي قدّم الاستجابة. تظل هذه السلوكيات في الاستجابات غير متحقق منها هنا.

تستخدم أخطاء Messages الصيغة {"type":"error","error":{"type":"...","message":"..."}}. لا تُفرض رسوم على الطلبات الفاشلة.

التحقق من التوافق: 2026-10-01

النتيجة	السلوك الذي تم فحصه
لوحظ أنه يعمل	النص الأساسي، وتذكّر المعلومات عبر أدوار المحادثة العادية المتعددة، وتعليمات النظام غير المتعارضة بصيغة سلاسل نصية/كتل، والبث المتدفق، وطلبات التفكير التكيفي والتفكير بين استدعاءات الأدوات، ومخرجات JSON، والأدوات بوضع auto/none، واستدعاء أداة في الوضع الصارم، وإعادة إرسال نتيجة أداة، ومدخلات الصور/PDF بصيغة base64، واستخدام الكتابة/القراءة لذاكرة التخزين المؤقت 5m/1h.
رُفض وفق مواصفات النموذج	ميزانيات توكنات المخرجات غير الصالحة، وإعدادات أخذ العينات المحذوفة، والتفكير اليدوي/المعطّل، والتركيبات غير الصالحة لوضع التفكير بين استدعاءات الأدوات، وفرض الأدوات، والملء المسبق لمحتوى المساعد، وأدوات الكمبيوتر القديمة، ومعرّفات البيانات الوصفية التي تتجاوز الحد المسموح.
قُبل، ولم يُثبت تأثيره	مستويات الجهد الخمسة كلها، والتفكير الملخّص، وإعدادات الربط، والبيانات الوصفية، وفئة الخدمة، واختيار المنطقة، والتشخيص، وقائمة تحرير سياق فارغة، وحاوية null، وقائمة MCP فارغة، والتصريح بمجموعة أدوات الكمبيوتر. التصريح بمجموعة الأدوات لا يؤكد نجاح استخدام الكمبيوتر.
اختلاف معروف	أعاد `max_tokens: 0` الرمز 400. أعاد طلب يتضمن تسلسل إيقاف سلسلة الإيقاف والنص اللاحق لها. أعاد ضغط السياق عند الطلب نصًا عاديًا بدلًا من كتلة ضغط سياق موقّعة.
سلوك إضافي يحتاج إلى التحقيق	لم يتذكر طلب يحدد مستوى الجهد لكل رسالة القيمة السابقة؛ واتبع اختبار بتعليمات نظام/مستخدم متعارضة تعليمات المستخدم. لا تثبت هذه النتائج فشل كل موجه نظام أو طلب محادثة متعدد الأدوار.

لم يُتحقَّق من البداية إلى النهاية من تنفيذ الأدوات التجريبية، أو اتصالات MCP الفعلية، أو مراجع Files API، أو الموقع الجغرافي لإقامة البيانات، أو إعادة إرسال توقيعات التفكير، أو الحدود القصوى الكاملة للسياق/المخرجات، أو الحالات الحدّية للوسائط، أو سلوك الرفض/التحويل إلى النماذج البديلة. لا يثبت HTTP 200 واسم النموذج المُعاد هوية النموذج الذي نُفّذ فعلًا، ولا أن جميع الخيارات المُرسلة قد دخلت حيز التنفيذ.