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 טוקנים שניתן לשמור במטמון. ה-API הרשמי תומך גם בנקודות חלוקה למטמון ברמת הבלוק.
`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, שלח שוב, ללא שינוי, את תוכן העוזר שהוחזר עבור כלי השרת. דחיסת ההקשר מסכמת את ההיסטוריה הקיימת ואינה מילוי מקדים של תוכן העוזר. שמור את בלוקי החשיבה והחתימות בדיוק כפי שהם; אל תעביר אותם בין מודלים ואל תערוך היסטוריה קודמת בלי לפעול לפי כללי הקישור הרשמיים.

ב-API המקורי של 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 API. בכל רשומה מותרים רק 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 ושם מודל שהוחזר אינם מאמתים איזה מודל רץ ואינם מוכיחים שכל האפשרויות שנשלחו אכן נכנסו לתוקף.