TL;DR
Claude Sonnet 5.5 เป็นโมเดลที่รวดเร็วสำหรับเวิร์กโฟลว์โค้ดที่ขอบเขตชัดเจน งานเอกสาร และการใช้เครื่องมือ Anthropic รายงานว่าให้ผลลัพธ์เร็วกว่า Sonnet 5 มากกว่า 30% ที่อัตราโทเค็นมาตรฐานเดียวกัน เริ่มต้นด้วยคีย์ CometAPI, รหัสโมเดล claude-sonnet-5-5 และคำขอสั้นๆ แบบ Messages หรือ Chat Completions เอเจนต์ที่มีอยู่ควรทดสอบใหม่ด้านการคิด การเลือกเครื่องมือ และการเล่นซ้ำประวัติก่อนเผยแพร่
Key Takeaways
- ใช้ Claude Sonnet 5.5 และจับคู่รูปแบบคำขอกับเอ็นด์พอยต์ของคุณ
- เริ่มจากคำขอสั้นเพียงหนึ่งครั้งก่อนเพิ่มรูปภาพ เครื่องมือ หรือคอนเท็กซ์ยาว
- ใช้ Messages เมื่อควบคุมเฉพาะของ Claude; ใช้ Chat Completions หากเป็นแอปที่ใช้ OpenAI SDK อยู่แล้ว
- ทบทวนการคิดและการเลือกเครื่องมือที่เปลี่ยนไปก่อนย้ายลูปเอเจนต์ที่มีอยู่
- เปรียบเทียบคุณภาพงานที่ยอมรับได้ ความหน่วง เวลาโทเค็น และอัตรา cache hit ก่อนเพิ่มทราฟฟิก
What Is Claude Sonnet 5.5?
Claude Sonnet 5.5 API คืออินเทอร์เฟซโปรแกรมสำหรับโมเดล Sonnet 5.5 ของ Anthropic ออกแบบมาสำหรับงานอย่างการพัฒนาซอฟต์แวร์ การวิเคราะห์รีโพซิทอรี ระบบอัตโนมัติสำหรับซัพพอร์ตลูกค้า การประมวลผลเอกสาร ความเข้าใจภาพ เอเจนต์ที่ใช้เครื่องมือ และเวิร์กโฟลว์ระดับมืออาชีพแบบมีโครงสร้าง
Anthropic วางตำแหน่ง Sonnet 5.5 เป็นคู่เสริมที่เร็วและต้นทุนต่ำกว่า Opus 5.5 ซึ่งเป็นโมเดลที่สองในตระกูล Claude 5.5 ปรับให้เหมาะกับงานโค้ดที่ขอบเขตชัด การแก้บั๊ก การสร้างเอกสารและสไลด์ และงานมืออาชีพประจำวัน นักพัฒนาสามารถเข้าถึง Claude Sonnet 5.5 API ผ่าน CometAPI โดยใช้ claude-sonnet-5-5
| สเปก | Claude Sonnet 5.5 |
|---|---|
| ผู้ให้บริการ | Anthropic |
| รหัสรุ่น | claude-sonnet-5-5 |
| วันที่เปิดตัว | 28 กันยายน 2026 |
| หน้าต่างคอนเท็กซ์ | 1M โทเค็น |
| เอาต์พุตซิงก์สูงสุด | 128K โทเค็น |
| เอาต์พุตแบบแบตช์สูงสุด | สูงสุด 300K โทเค็นในคอนฟิกเบตาที่รองรับ |
| อินพุต | ข้อความ, รูปภาพ |
| เอาต์พุต | ข้อความ |
| โหมดคิด | Adaptive thinking |
| ค่า effort เริ่มต้นของ Claude API | High |
| ความรู้ถึง | มิถุนายน 2026 |
| ราคาอินพุต (Anthropic / CometAPI) | $2.00 / $1.60 ต่อ 1M โทเค็น |
| ราคาเอาต์พุต (Anthropic / CometAPI) | $10.00 / $8.00 ต่อ 1M โทเค็น |
Anthropic ยืนยันหน้าต่างคอนเท็กซ์ 1M โทเค็นและขีดจำกัดเอาต์พุตซิงก์ 128K เอาต์พุตแบบแบตช์สามารถถึง 300K โทเค็นได้เฉพาะผ่าน Message Batches พร้อมเฮดเดอร์เบต้า output-300k-2026-03-24 การรองรับฟีเจอร์ของ Gateway ต้องตรวจสอบแยกจากการรองรับในระดับโมเดล
How Does Claude Sonnet 5.5 Perform on Official Benchmarks?
การเปรียบเทียบแบบย่อด้านล่างช่วยระบุเวิร์กโหลดที่จะประเมินก่อนรับ API ไปใช้จริง ผลเบนช์มาร์กไม่สามารถทดแทนการทดสอบพรอมต์และลูปเครื่องมือของคุณเอง
| เบนช์มาร์ก | Claude Sonnet 5.5 | Claude Sonnet 5 | Claude Opus 5.5 |
|---|---|---|---|
| Terminal-Bench 4.0 | 70.6% | 10.3% | 66.4% ที่ Xhigh |
| FrontierCode 1.1 Main | 46.2% ที่ Max / 52.1% ที่ Xhigh | 42.4% | 54.4% |
| CursorBench 4.0 | 55.5% | 34.1% | 57.8% |
| GDPval-AA v2.1 | 1844 | 1449 | 1846 |
| OSWorld 2.1, partial | 80.1% | 57.0% | 81.8% |
| AA-Briefcase v1.1 | 1811 | 1359 | 1822 |
| Humanity’s Last Exam, with tools | 64.5% | 54.9% | 67.7% |
| Chartography, no tools | 61.6% | 15.6% | 64.4% |
ผลลัพธ์และบันทึกการประเมินของ Anthropic ให้พื้นฐานสำหรับการเปรียบเทียบนี่ Opus 5.5 ใน Terminal-Bench ใช้ effort ระดับ Xhigh; FrontierCode รายงานผล Max และ Xhigh แยกกันสำหรับ Sonnet 5.5; OSWorld เป็นการประเมินบางส่วน GDPval-AA และ AA-Briefcase รันโดย Artificial Analysis บนการปรับใช้ Claude Platform ก่อนเปิดตัวที่มีบั๊ก structured-output ซึ่งน่าจะทำให้คะแนนของ Sonnet 5.5 ต่ำกว่าจริง; Anthropic ระบุว่าบั๊กได้รับการแก้ไขแล้ว ผลลัพธ์เหล่านี้ควรใช้เป็นแนวทางในการทดสอบเวิร์กโหลด ไม่ใช่การรับประกันผลลัพธ์ในโปรดักชัน Humanity’s Last Exam ใช้เครื่องมือ; Chartography ไม่ใช้ แถวใหม่ใช้คะแนนที่ Anthropic เผยแพร่ ภาพต้นฉบับด้านล่างยังคงไว้; ตารางที่ขยายรวมการประเมินเพิ่มเติมอีกสามรายการ
การเปรียบเทียบเบนช์มาร์กอย่างเป็นทางการของ Claude Sonnet 5.5
What Changed in Claude Sonnet 5.5 API From Sonnet 5?
| มิติ | Claude Sonnet 5.5 | ผลกระทบต่อการย้าย |
|---|---|---|
| ความเร็วเอาต์พุต | รายงานว่าเร็วขึ้นมากกว่า 30% | ตั้งค่าเบสไลน์ความหน่วงใหม่ |
| อัตราโทเค็นทางการ | เท่าเดิม $2 อินพุต / $10 เอาต์พุต ต่อ MTok | เปรียบเทียบต้นทุนงานทั้งหมด |
| การตั้งค่า thinking ต่ำสุด | between_tools แทน disabled | อัปเดตการกำหนดค่าการคิด |
| บังคับเลือกเครื่องมือ | ปฏิเสธทั้ง any และการบังคับชื่อ | ใช้ auto; เรียงลำดับขั้นตอนที่ต้องทำในโค้ด |
| ประวัติการคิด | เซ็นผูกกับบทสนทนาและบัญชี | คงบล็อกและประวัติที่เสถียร |
| ความเข้ากันได้กับ computer use | computer_20251124 ถูกปฏิเสธบน Claude API / Google Cloud | ย้ายไป computer_toolset_20260801; ตรวจสอบการรองรับ gateway |
| ความเข้ากันได้กับ advisor model | การจับคู่ advisor รุ่นเก่าถูกปฏิเสธ | เลือก advisor ที่รองรับ เช่น Opus 5.5 |
การเปลี่ยนแปลงด้านการคิด การเลือกเครื่องมือ และการเล่นซ้ำประวัติส่งผลต่อ ลูปเอเจนต์ที่มีอยู่ ตารางนี้สรุปการเปลี่ยนเชิงปฏิบัติการ ไม่ใช่รายการฟีเจอร์ครบถ้วน
Breaking Changes to Check
ตรวจสอบการเปลี่ยนแปลงที่ทำให้แตกหักทั้งห้าข้อ: แทนที่การคิดแบบ disabled ด้วย between_tools; ลบการบังคับเลือกเครื่องมือ; คงบล็อกการคิดที่เข้ากันได้และประวัติบทสนทนาเดิม; ย้ายจาก computer_20251124 ไปเป็น computer_toolset_20260801 บน Claude API และ Google Cloud; และแทนที่การจับคู่ advisor ที่ไม่รองรับ Amazon Bedrock ยังยอมรับ computer_20251124 Advisor ที่ไม่รองรับ ได้แก่ Opus 4.8, 4.7, 4.6, Sonnet 5, Sonnet 4.6 และ Haiku 5.5 Opus 5.5 เป็นหนึ่งในตัวเลือกที่รองรับ อ่านบล็อกการตอบกลับตามประเภท ตรวจสอบความเข้ากันได้ของแพลตฟอร์มและ gateway ก่อนเผยแพร่ คู่มือการย้ายอย่างเป็นทางการ
Additional Capabilities and Workflow Changes
ใช้ คู่มือฟีเจอร์อย่างเป็นทางการ เพื่อทบทวนความคืบหน้า การตั้งค่า effort ต่อข้อความ และการควบคุมกลางบทสนทนา ยืนยันการรองรับของ gateway ก่อนเปิดใช้ฟีเจอร์เบต้า
What Do You Need Before Using the Claude Sonnet 5.5 API?
- บัญชี CometAPI, คีย์ API, การเข้าถึงโมเดล และยอดการเรียกเก็บเงินเพียงพอ
- เทอร์มินัลพร้อม cURL; Python และ pip หรือ Node.js และ npm สำหรับตัวอย่าง SDK
- เลือกเอ็นด์พอยต์:
/v1/messagesหรือ/v1/chat/completions - เก็บ
COMETAPI_KEYในสภาพแวดล้อมฝั่งเซิร์ฟเวอร์ และมีเครือข่ายเข้าถึงhttps://api.cometapi.com - พรอมต์ทดสอบสั้นๆ และการตรวจสอบที่ชัดเจนสำหรับผลลัพธ์ที่ใช้งานได้ สถานะการจบ และการใช้โทเค็น
How Do You Access Claude Sonnet 5.5 API Through CometAPI?
| รูปแบบ API | เอ็นด์พอยต์ | เหมาะสำหรับ |
|---|---|---|
| Claude-native Messages API | POST /v1/messages | เครื่องมือเฉพาะของ Claude การควบคุมการคิด เวิร์กโฟลว์เอเจนต์ โครงสร้างการตอบกลับของ Anthropic |
| OpenAI-compatible Chat Completions | POST /v1/chat/completions | โปรเจ็กต์ OpenAI SDK ที่มีอยู่ ตัวจัดเส้นทางโมเดล แอปข้ามโมเดล |
เลือก Messages API เมื่อพฤติกรรมของ Claude เองมีความสำคัญ เลือก API ที่เข้ากันได้กับ OpenAI เมื่อแอปของคุณสลับระหว่าง Claude, GPT, Gemini, DeepSeek หรือโมเดลอื่นๆ ผ่านเลเยอร์เดียวกันอยู่แล้ว
Step 1: Store the API Key
สร้างคีย์ใน คอนโซล CometAPI API key จากนั้นตั้งค่าในสภาพแวดล้อมรันไทม์ของคุณ
ตั้งค่า CometAPI key ใน POSIX shell
export COMETAPI_KEY="YOUR_COMETAPI_KEY"
ตั้งค่า CometAPI key ใน PowerShell
$env:COMETAPI_KEY="YOUR_COMETAPI_KEY"
Step 2: Make the First Messages Request
ส่งคำขอ Messages ที่เข้ากันได้กับ Anthropic ครั้งแรก
curl https://api.cometapi.com/v1/messages \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 2048,
"messages": [{"role": "user", "content": "Explain exponential backoff in three bullet points."}]
}'
ตรวจสอบ content blocks, stop_reason และ usage ก่อนเพิ่มการควบคุมเพิ่มเติม ไวยากรณ์ cURL ด้านบนใช้ POSIX shell
Step 3: Use the Anthropic Python SDK
ติดตั้ง Anthropic Python SDK
pip install anthropic
อ่าน text blocks และ usage ด้วย Anthropic SDK
import os
import anthropic
anthropic_client = anthropic.Anthropic(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com",
)
response = anthropic_client.messages.create(
model="claude-sonnet-5-5",
max_tokens=4096,
messages=[{"role": "user", "content": "Review this migration plan and list the three biggest risks."}],
)
for block in response.content:
if block.type == "text":
print(block.text)
print("Completion:", response.stop_reason)
print("Usage:", response.usage)
Step 4: Use the OpenAI Python SDK
ติดตั้ง OpenAI Python SDK
pip install openai
เรียก Sonnet 5.5 ผ่าน OpenAI-compatible Chat Completions
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1",
)
response = client.chat.completions.create(
model="claude-sonnet-5-5",
messages=[
{
"role": "system",
"content": "You are a concise software engineering assistant."
},
{
"role": "user",
"content": "Review this function and identify the highest-risk bug."
}
],
)
print(response.choices[0].message.content)
แนวทางนี้มีประโยชน์เมื่อแอปใช้อินเทอร์เฟซ OpenAI SDK อยู่แล้ว การผสานแบบข้อความพื้นฐานอาจต้องเพียง base URL, คีย์ API และรหัสโมเดลใหม่ แต่การย้ายโปรดักชันยังคงต้องยืนยันพารามิเตอร์ที่รองรับ รูปแบบการตอบกลับ การเรียกเครื่องมือ สตรีมอีเวนต์ การหมดเวลา และการนับโทเค็น
Step 5: Use JavaScript in Node.js
ติดตั้ง OpenAI Node.js SDK
npm install openai
เรียก Sonnet 5.5 จาก Node.js ES module
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.COMETAPI_KEY,
baseURL: "https://api.cometapi.com/v1",
});
const response = await client.chat.completions.create({
model: "claude-sonnet-5-5",
messages: [
{
role: "user",
content: "Create a TypeScript function that validates an email address.",
},
],
});
console.log(response.choices[0].message.content);
สำหรับแอป Node.js ฝั่งแบ็กเอนด์ ให้เก็บ COMETAPI_KEY ในสภาพแวดล้อมเซิร์ฟเวอร์แทนการส่งไปยังไคลเอนต์เบราว์เซอร์
Claude Sonnet 5.5 Thinking and Effort Levels
API ตั้งค่า effort เป็น high โดยเริ่มต้น; แอปพลิเคชัน Claude และ Claude Code ใช้ medium เลือก effort โดยพิจารณาคุณภาพงานที่ยอมรับได้ ความหน่วง และค่าโทเค็น ตารางด้านล่างเป็นจุดเริ่มต้นเชิงบรรณาธิการ ไม่ใช่การจัดประเภทเวิร์กโหลดอย่างเป็นทางการ
| เวิร์กโหลด | ระดับ effort เริ่มต้นที่แนะนำ |
|---|---|
| การสกัดข้อมูล | Low |
| การจัดหมวดหมู่ | Low |
| การตอบซัพพอร์ตประจำ | Low หรือ Medium |
| อธิบายโค้ด | Medium |
| แก้บั๊ก | Medium |
| โค้ดระดับรีโพซิทอรี | High |
| เวิร์กโฟลว์เอเจนต์ที่ซับซ้อน | High |
| รีวิวโปรดักชันที่มีค่าใช้จ่ายสูง | High แล้วประเมินเทียบ Opus |
| งานโค้ดหรือเอเจนต์ที่ยากและยาว | Xhigh ใช้เฉพาะเมื่อประเมินแล้วได้คุณภาพดีขึ้น |
| งานที่ไวต่อความสามารถส่วนใหญ่และมีงบประมาณค่าบริการที่รับได้ | Max ใช้เฉพาะเมื่อการประเมินยืนยันว่าคุ้มความหน่วงและโทเค็น |
หลีกเลี่ยงการตั้งค่าระดับสูงสุดให้ทุกคำขอโดยอัตโนมัติ เวิร์กโหลดเอเจนต์อาจมีค่าใช้จ่ายสูงขึ้นอย่างมีนัยสำคัญเมื่อการให้เหตุผลเพิ่มก่อให้เกิดการเรียกเครื่องมือเพิ่มและเอาต์พุตยาวขึ้น เลือกการตั้งค่าตามระดับงาน ใช้ adaptive thinking สำหรับ Xhigh และ Max แล้วเปรียบเทียบคุณภาพงานที่ยอมรับได้และต้นทุนรวมกับระดับต่ำกว่า คำแนะนำ effort อย่างเป็นทางการ
Configure Effort Through Messages
ตัวอย่างนี้ใช้ไคลเอนต์ Anthropic ที่เริ่มต้นไว้ข้างต้น ทดสอบการควบคุมเดียวกันบนเส้นทาง CometAPI ของคุณก่อนเผยแพร่
ตั้งค่า adaptive thinking และ high effort
response = anthropic_client.messages.create(
model="claude-sonnet-5-5",
max_tokens=8192,
thinking={"type": "adaptive"},
output_config={"effort": "high"},
messages=[{"role": "user", "content": "Audit this service migration plan."}],
)
Turn Off Up-Front Thinking
ใช้ thinking={"type": "between_tools"} ที่ระดับ low, medium หรือ high ใช้ adaptive thinking สำหรับ xhigh หรือ max between_tools ไม่มีฟิลด์ display หรือ budget_tokens และไม่อนุญาตให้เปลี่ยน effort กลางบทสนทนา
Preserve Thinking in Tool Loops
ส่งคืน assistant content blocks เดิมก่อนแนบผลเครื่องมือ การคิดที่คงอยู่ขึ้นกับโมเดล คำขึ้นต้นบทสนทนา และบัญชีผู้ผลิต การผูก prefix ถูกบังคับใช้เป็นค่าเริ่มต้นบน Claude API, Amazon Bedrock และ Google Cloud สำหรับบัญชีที่สร้างตั้งแต่ 31 สิงหาคม 2026 เวลา 00:00 UTC เป็นต้นไป อย่าคาดว่าทุก gateway จะเปิดเผยการควบคุมการผูกแบบเดียวกัน
How to Stream Claude Sonnet 5.5 Responses
Stream Long Responses
สตรีมมิ่งมีประโยชน์สำหรับอินเทอร์เฟซแชต ผู้ช่วยเขียนโค้ด และคำตอบยาวๆ เพราะผู้ใช้สามารถเห็นเอาต์พุตก่อนการสร้างเสร็จ
สตรีมข้อความผ่าน OpenAI-compatible Chat Completions
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1",
)
stream = client.chat.completions.create(
model="claude-sonnet-5-5",
messages=[
{
"role": "user",
"content": "Explain how a retrieval-augmented generation pipeline works."
}
],
stream=True,
)
for chunk in stream:
if not chunk.choices:
continue
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)
สตรีมมิ่งโดยทั่วไปไม่ได้ลดจำนวนโทเค็นที่สร้างทั้งหมด ประโยชน์หลักคือความหน่วงที่รับรู้ แอปควรจัดการสตรีมที่ขาดตอน เอาต์พุตบางส่วน การลองเชื่อมต่อใหม่ และการยกเลิกอย่างชัดเจน
Use Tools With Automatic Selection
ใช้ tool_choice={"type": "auto"} ตรวจสอบความถูกต้องชื่อเครื่องมือและอาร์กิวเมนต์ ใช้การอนุญาตและการหมดเวลา ส่งคืนผลลัพธ์แบบมีโครงสร้าง และจำกัดจำนวนรอบ การดำเนินการเครื่องมือที่จำเป็นควรอยู่ใน orchestration ของแอปพลิเคชัน
กำหนดเครื่องมือค้นหา ticket และขอเลือกอัตโนมัติ
tools = [{
"name": "lookup_ticket",
"description": "Retrieve a support ticket by ID",
"input_schema": {
"type": "object",
"properties": {"ticket_id": {"type": "string"}},
"required": ["ticket_id"],
"additionalProperties": False,
},
}]
response = anthropic_client.messages.create(
model="claude-sonnet-5-5",
max_tokens=4096,
tools=tools,
tool_choice={"type": "auto"},
messages=[{"role": "user", "content": "Look up ticket T-123 and summarize its status."}],
)
บล็อก tool_use จะร้องขอการดำเนินการ; คำขอครั้งแรกนี้ยังไม่รันการกระทำนั้น ตรวจสอบคำขอบนเซิร์ฟเวอร์ของคุณ รันการปฏิบัติการ แนบ assistant content โดยไม่เปลี่ยนแปลง แล้วส่ง tool_result ที่ตรงกัน สคีมาของตัวอย่างนี้ยังต้องการการตรวจสอบโดยแอป ตรวจสอบการรองรับเครื่องมือแบบ strict บนเส้นทางที่เลือก
Use Prompt Caching for Repeated Context
Prompt caching มีประโยชน์เมื่อคำขอบรรจุ prefix ขนาดใหญ่เดิมซ้ำๆ เช่น นโยบายระบบ สคีมาของเครื่องมือ แผนที่รีโพซิทอรี เอกสารผลิตภัณฑ์ คำแนะนำที่ใช้ซ้ำ หรือคู่มืออ้างอิง
Sonnet 5.5 ต้องการ prefix ที่แคชได้อย่างน้อย 512 โทเค็น Prefix ที่สั้นกว่าจะถูกประมวลผลโดยไม่มีการแคช แม้จะมี cache_control ตรวจสอบ cache_creation_input_tokens และ cache_read_input_tokens; หากทั้งสองเป็นศูนย์ แสดงว่าไม่มีการใช้แคช ยืนยันการรองรับบนเส้นทาง gateway ของคุณ อ้างอิง prompt caching
จัดวางคอนเท็กซ์คงที่ก่อนคอนเท็กซ์แบบไดนามิกในคำขอล่าสุด
Stable system instructions
Stable tools
Stable repository or knowledge context
---------------- cache boundary ----------------
Current user request
Current retrieved context
อัตรา cache-read ปัจจุบันของ CometAPI คือ $0.16 ต่อหนึ่งล้านโทเค็น เทียบกับ $1.60 สำหรับอินพุตสด การเขียนแคชชาร์จแยกต่างหาก ตรวจสอบ cache hits ในเมทาดาทาการใช้งานก่อนประเมินการประหยัด
การแคชมีประโยชน์อย่างยิ่งสำหรับเอเจนต์โค้ดและผู้ช่วยในองค์กรที่ใช้ prefix คอนเท็กซ์ขนาดใหญ่ซ้ำหลายเทิร์น เศรษฐศาสตร์ขึ้นกับ cache hit จริง; การเขียน prefix คงที่ใหม่บ่อยๆ อาจทำให้ประโยชน์ส่วนใหญ่หายไป
Send Images Using the Selected Endpoint Schema
Sonnet 5.5 รับอินพุตข้อความและรูปภาพ JSON ด้านล่างเป็น payload ของ OpenAI-compatible Chat Completions; แทนที่ URL รูปภาพตัวอย่างด้วยรูปภาพที่เข้าถึงสาธารณะซึ่งคุณควบคุม Messages ใช้สคีมาบล็อกรูปภาพที่แตกต่างกัน
ส่งรูปภาพใน payload ของ Chat Completions
{
"model": "claude-sonnet-5-5",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "Find the three most important UI problems in this screenshot."
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/interface.png"
}
}
]
}
]
}
รูปแบบคำขอมัลติโหมดที่แน่นอนอาจแตกต่างกันระหว่างอินเทอร์เฟซ Claude-native และ OpenAI-compatible ดังนั้นใช้สคีมาของเอ็นด์พอยต์ที่คุณใช้งานจริงแทนที่จะสมมติว่าทั้งสองสามารถใช้แทนกันได้
Handle Safeguards and Retained Data
บันทึกการปฏิเสธและพฤติกรรม fallback เป็นสถานะของแอปอย่างชัดเจน Anthropic อธิบาย มาตรการป้องกันและความพร้อมใช้งานแบบ zero-data-retention สำหรับบริการของตน ตรวจสอบการจัดเก็บและการกำหนดเส้นทางที่ใช้กับ gateway ของคุณแยกต่างหากก่อนส่งข้อมูลโปรดักชัน
Claude Sonnet 5.5 vs Sonnet 5 vs Opus 5.5
ป้ายกำกับเชิงคุณภาพด้านล่างเป็นคำแนะนำการจัดเส้นทางตามขอบเขตงาน ไม่ใช่คะแนนประสิทธิภาพอย่างเป็นทางการ ตรวจสอบบทบาทเหล่านี้บนเวิร์กโหลดตัวแทน หลีกเลี่ยงการอนุมานสถาปัตยกรรมโดยละเอียดจากคะแนนเบนช์มาร์ก
| มิติ | Claude Sonnet 5 | Claude Sonnet 5.5 | Claude Opus 5.5 |
|---|---|---|---|
| โค้ดประจำ | แข็งแกร่ง | แข็งแกร่งกว่าและเร็วกว่า | มักไม่จำเป็น |
| งานระดับรีโพซิทอรี | แข็งแกร่ง | แข็งแกร่งมาก | เหมาะที่สุดสำหรับเคสยาก |
| เอเจนต์ที่ขอบเขตชัดเจน | แข็งแกร่ง | ตัวเลือกหลัก | มีประโยชน์สำหรับเวิร์กโฟลว์ที่ยากขึ้น |
| งานกำกวมยาวนาน | ดี | ดีมาก | ตัวเลือกหลัก |
| ความเร็วเอาต์พุต | พื้นฐาน | เร็วกว่า Sonnet 5 มากกว่า 30% | ปรับเพื่อความสามารถมากกว่าผลิตผ่านต้นทุนต่ำ |
| ราคาอินพุตทางการ | $2/M | $2/M | $4/M |
| ราคาเอาต์พุตทางการ | $10/M | $10/M | $20/M |
| บทบาทโปรดักชันทั่วไป | งาน Sonnet ที่มีอยู่ | ตัวเลือก Sonnet เริ่มต้น | ชั้นยกระดับ/ความซับซ้อนสูง |
| หน้าต่างคอนเท็กซ์ | 1M โทเค็น | 1M โทเค็น | 1M โทเค็น |
| อินพุต / เอาต์พุต | ข้อความและรูปภาพ / ข้อความ | ข้อความและรูปภาพ / ข้อความ | ข้อความและรูปภาพ / ข้อความ |
| โหมดคิด | Adaptive | Adaptive; between_tools ที่ high หรือต่ำกว่า | Adaptive, เปิดตลอด |
| การมีใน API | ผสานกับ CometAPI ที่มีอยู่ | CometAPI Messages และ Chat Completions ที่เข้ากันได้ | ใช้งานผ่าน CometAPI |
จัดเส้นทางงานยากไปยังโมเดลระดับ escalation
Routine task
↓
Claude Sonnet 5.5
↓
Confidence / validation failure?
├── No → Return result
└── Yes → Escalate difficult case
↓
Opus-class model
รูปแบบการจัดเส้นทางนี้ช่วยลดต้นทุนขณะยังคงเข้าถึงระดับให้เหตุผลที่แข็งแกร่งกว่าสำหรับเคสยาก
Claude Sonnet 5.5 Pricing Through CometAPI
| ประเภทการคิดเงิน | Anthropic | CometAPI |
|---|---|---|
| อินพุต | $2.00 / 1M โทเค็น | $1.60 / 1M โทเค็น |
| เอาต์พุต | $10.00 / 1M โทเค็น | $8.00 / 1M โทเค็น |
| อ่านแคช | $0.10 / 1M โทเค็น | $0.16 / 1M โทเค็น |
| เขียนแคช (TTL 5 นาที) | $2.50 / 1M โทเค็น | $2.00 / 1M โทเค็น |
ตรวจสอบเมื่อ 10 ตุลาคม 2026: ราคาขาเข้า/ขาออกของ CometAPI ยังคง $1.60/$8 ต่อหนึ่งล้านโทเค็น ต่ำกว่า Anthropic 20% ที่ $2/$10 ค่าอ่าน/เขียนแคชของ CometAPI ยังคง $0.16/$2; ค่าอ่าน/เขียนแคชปัจจุบันของ Anthropic คือ $0.10/$2.50 สำหรับการเขียน 5 นาที หน้าเปิดตัวยังแสดงค่าอ่านแคช $0.20; การปรับปรุงนี้ใช้ อ้างอิงการแคชปัจจุบัน ราคาของ gateway สามารถเปลี่ยนแยกจากกันได้
ความแตกต่างระหว่างราคาโทเค็นและต้นทุนงานสำคัญสำหรับแอปเอเจนต์ เอเจนต์โค้ดอาจสร้างโทเค็นน้อยลงแต่ยังดำเนินการหลายรอบของการเรียกเครื่องมือ การอ่านแคช การตรวจโค้ด การลองใหม่ และการตรวจสอบ ดังนั้นต้นทุนต่อภารกิจที่สำเร็จจึงมักให้ข้อมูลมากกว่าราคาโทเค็นอินพุตเพียงอย่างเดียว
ประมาณค่าชาร์จโทเค็นอินพุตสดและเอาต์พุต
Input:
100,000 / 1,000,000 × $1.60 = $0.16
Output:
5,000 / 1,000,000 × $8.00 = $0.04
Estimated model-token cost:
$0.20
ค่าธรรมเนียมเครื่องมือ การดำเนินการแคช ขั้นตอนเอเจนต์ที่ซ้ำ หรือฟีเจอร์ที่เสียค่าใช้จ่ายอื่นๆ อาจเปลี่ยนต้นทุนสุดท้ายได้
ตรวจสอบราคาอีกครั้งเมื่อ 10 ตุลาคม 2026 กับ หน้ารุ่นปัจจุบันของ CometAPI ราคาขาเข้า/ขาออกสดไม่เปลี่ยน ดังนั้นตัวอย่างคำนวณยังเป็น $0.16 + $0.04 = $0.20 สำหรับอินพุตสด 100,000 และเอาต์พุต 5,000 โทเค็น ไม่รวมการเขียน/อ่านแคช ค่าธรรมเนียมเครื่องมือ และการลองใหม่ ตรวจสอบการคิดเงินตามเส้นทางก่อนจัดงบประมาณ
Control Cost per Accepted Task
มีหลายวิธีใช้งานได้จริงเพื่อลดค่าใช้จ่ายโดยไม่ต้องสลับโมเดลทันที ขั้นแรก กำหนดเกณฑ์การยอมรับผลตอบกลับให้ชัด:
กำหนดรูปแบบการตอบกลับที่โฟกัส
Return only:
1. the root cause;
2. the affected file;
3. the smallest safe fix;
4. one regression test.
ประการที่สอง ตัดแต่งคอนเท็กซ์ที่เรียกคืนก่อนส่ง หน้าต่างคอนเท็กซ์ 1M โทเค็นเป็นขีดความสามารถ ไม่ใช่เป้าหมาย ประการที่สาม ใช้ prompt caching เพื่อใช้คอนเท็กซ์คงที่ซ้ำ ประการที่สี่ เลือก effort ตามเวิร์กโหลดแทนการตั้ง High ให้ทุกคำขอ ประการที่ห้า วัดต้นทุนต่อผลลัพธ์ที่ยอมรับได้:
คำนวณต้นทุนต่อภารกิจที่ยอมรับได้
Total API cost
÷
Number of outputs accepted without rework
คำขอที่ถูกกว่าไม่จำเป็นต้องหมายถึงเวิร์กโฟลว์ที่ถูกกว่า หากทำให้เกิดการลองใหม่ การแก้ไข หรือการเรียกเครื่องมือเพิ่ม
How Do You Migrate From Sonnet 5 to Claude Sonnet 5.5 API?
- เก็บคอนฟิกโปรดักชันก่อนหน้าไว้สำหรับย้อนกลับ
- เปลี่ยนรหัสโมเดลจาก claude-sonnet-5 เป็น claude-sonnet-5-5
- ใช้การเปลี่ยนแปลงด้านการคิด การเลือกเครื่องมืออัตโนมัติ และประวัติที่อธิบายไว้ข้างต้น
- เล่นซ้ำคำขอตัวแทน รวมทั้งเครื่องมือ รูปภาพ และสตรีมมิ่ง
- เปรียบเทียบเอาต์พุตที่ยอมรับได้ อัตราการแก้โดยมนุษย์ ความหน่วง p50/p95 และต้นทุนงานรวม
- ทดสอบการลองใหม่ การปฏิเสธ การยกเลิก และสตรีมที่ขาดตอน
- ตรวจสอบ cache hit และพฤติกรรมขีดจำกัดเอาต์พุตจากเมทาดาทาการใช้งาน
- ปล่อยทราฟฟิกแบบ canary ขนาดเล็ก และขยายเฉพาะเมื่อผ่านเกณฑ์การยอมรับ
Troubleshooting Claude Sonnet 5.5 API Errors
| อาการ | ตรวจสอบอะไรบ้าง |
|---|---|
| 400: invalid thinking setting | แทน disabled ด้วย between_tools ที่ high หรือต่ำกว่า; ใช้ adaptive สำหรับ xhigh/max |
| 400: forced tool selection | ลบการบังคับเลือกเครื่องมือทั้ง any หรือแบบระบุชื่อ; ใช้ auto |
| 400 หลังเล่นซ้ำประวัติ | สำหรับบัญชีที่บังคับใช้ prefix binding ให้คงการคิดที่เซ็นและประวัติก่อนหน้าไม่เปลี่ยน; ตรวจสอบความเข้ากันได้ของโมเดล/บัญชีและเส้นทางที่เลือก |
| 401 / 403 | ตรวจสอบข้อมูลยืนยันสิทธิ์ การอนุญาต และการเข้าถึงโมเดล |
| 429 / 5xx ที่ลองใหม่ได้ | ใช้ bounded exponential backoff พร้อม jitter และเคารพ Retry-After เมื่อมี |
| ไม่มีข้อความธรรมดาในคำตอบ | ตรวจสอบประเภทเนื้อหา สถานะการจบ การปฏิเสธ และพฤติกรรม fallback |
| เอาต์พุตสิ้นสุดก่อนเวลา | ตรวจสอบ stop_reason หรือ finish_reason; ปรับงบประมาณเอาต์พุตและใช้สตรีมมิ่ง |
| แคชไม่เคยโดน | ตรวจสอบ prefix คงที่และเมทาดาทาการใช้แคช |
| สตรีมหลุด | เก็บเอาต์พุตบางส่วนและลองใหม่ตามกฎ idempotency ของแอป |
อย่าลองใหม่คำขอที่รูปแบบผิดหรือการยืนยันตัวตนล้มเหลวโดยไม่เปลี่ยนแปลง ป้องกันการกระทำเครื่องมือซ้ำเมื่อเล่นซ้ำการรันเอเจนต์ที่ขาดตอน
Claude Sonnet 5.5 Production Best Practices
เลือกเวิร์กโหลด กำหนดเกตยอมรับ และประเมินแอปทั้งระบบ บันทึกโมเดล ID เอ็นด์พอยต์ effort ความหน่วง การใช้โทเค็นและแคช ความล้มเหลวของเครื่องมือ สถานะการจบ และผลลัพธ์งานที่ยอมรับได้ เก็บคีย์ไว้ฝั่งเซิร์ฟเวอร์และกำหนด timeout การลองใหม่แบบมีขอบเขต และขีดจำกัดรอบเอเจนต์
Measure Workflow Quality and Reliability
| เมตริก | เหตุผลที่สำคัญ |
|---|---|
| อัตราความสำเร็จงาน | วัดการเสร็จสิ้นเวิร์กโฟลว์จริง |
| อัตราการแก้โดยมนุษย์ | เผยปัญหาคุณภาพที่ซ่อนอยู่ |
| โทเค็นอินพุต | ควบคุมต้นทุนคอนเท็กซ์ |
| โทเค็นเอาต์พุต | ควบคุมต้นทุนการสร้าง |
| อัตรา cache-hit | กำหนดคุณค่าของการแคช |
| จำนวนการเรียกเครื่องมือ | ตรวจจับเอเจนต์ที่ไม่มีประสิทธิภาพ |
| เครื่องมือเรียกไม่ถูกต้อง | วัดความน่าเชื่อถือของ orchestration |
| อัตราการลองใหม่ | เผยความไม่เสถียรของ API หรือเวิร์กโฟลว์ |
| ความหน่วง p50 | ประสบการณ์ผู้ใช้ทั่วไป |
| ความหน่วง p95 | ประสบการณ์ผู้ใช้ในหางยาว |
| ต้นทุนต่อภารกิจยอมรับได้ | เชื่อมคุณภาพกับเศรษฐศาสตร์ |
สำหรับเอเจนต์โค้ด ให้ติดตามจำนวนเทสที่ผ่าน ไฟล์ที่แก้โดยไม่จำเป็น แพตช์ที่ย้อนกลับ และการเสร็จสิ้นโดยไม่มีมนุษย์
Example: Fix a Well-Scoped Repository Bug
จัดเตรียมเทสที่ล้มเหลว ไฟล์ซอร์สที่เกี่ยวข้อง และพฤติกรรมที่คาดหวัง ขอแพตช์ที่โฟกัสพร้อมการตรวจถอยหลัง เกตยอมรับคือการแก้ที่ทำซ้ำได้ เทสที่เกี่ยวข้องผ่าน และไม่มีการแก้ไขที่ไม่เกี่ยวข้อง เปรียบเทียบต้นทุน API และเครื่องมือรวมกับแพตช์ที่ยอมรับได้
Example: Triage a Support Ticket
ดึงปัญหาของลูกค้าและย่อหน้าที่ได้รับอนุมัติจากฐานความรู้ ขอให้โมเดลจัดหมวดหมู่ปัญหา ร่างคำตอบที่มีหลักฐานสนับสนุน และระบุเคสที่ต้องยกระดับ ยอมรับผลลัพธ์เมื่อคำกล่าวสอดคล้องกับวัสดุที่เรียกคืนและการตัดสินใจการส่งต่อเป็นไปตามนโยบายซัพพอร์ต
Example: Review a Document and Screenshot
จัดเตรียมขั้นตอนที่ได้รับอนุมัติและภาพหน้าจอของอินเทอร์เฟซที่สอดคล้อง ขอความแตกต่างพร้อมการอ้างอิงถึงย่อหน้าที่เกี่ยวข้องและองค์ประกอบ UI ที่มองเห็นได้ ต้องมีผู้ตรวจทานยืนยันผลก่อนเปลี่ยนขั้นตอน
Conclusion
Claude Sonnet 5.5 มอบตัวเลือกที่ใช้งานจริงสำหรับเวิร์กโฟลว์โค้ด ซัพพอร์ต เอกสาร และเอเจนต์ที่ใช้เครื่องมือ เริ่มจากคำขอ CometAPI ที่ใช้งานได้ แล้วค่อยเพิ่มการควบคุมที่แอปของคุณต้องการ
การย้ายต้องมากกว่าการเปลี่ยนรหัสโมเดล: ตรวจสอบการตั้งค่าการคิด การเลือกเครื่องมืออัตโนมัติ การแยกวิเคราะห์การตอบกลับ และการเล่นซ้ำประวัติ โปรโมตโมเดลเมื่อการประเมินเวิร์กโหลดของคุณแสดงความสมดุลที่ยอมรับได้ระหว่างคุณภาพ ความหน่วง และต้นทุน; สงวนชั้นที่แข็งแกร่งกว่าไว้สำหรับงานที่ไม่ผ่านเกตยอมรับของคุณ
FAQ
How Should Teams Rotate a Claude Sonnet 5.5 API Key Without Downtime?
เก็บคีย์ไว้ในตัวจัดการความลับฝั่งเซิร์ฟเวอร์และให้เวิร์กเกอร์โหลดข้อมูลรับรองใหม่โดยไม่ฝังคีย์ในโค้ด หากผู้ให้บริการรองรับคีย์ที่ซ้อนทับกันได้ ให้นำคีย์ใหม่เข้าไว้ก่อน ตรวจคำขอเล็กๆ ว่าใช้งานได้ ค่อยๆ สลับเวิร์กเกอร์ แล้วเพิกถอนคีย์เดิม ติดตามข้อผิดพลาดการยืนยันตัวตนระหว่างการเปลี่ยน และหลีกเลี่ยงการบันทึกคีย์ทั้งสอง
How Can a Claude Sonnet 5.5 Job Resume After a Worker Restart?
บันทึกตัวระบุงาน ขั้นตอนล่าสุดที่เสร็จ คอนฟิกคำขอ และบันทึกการรันเครื่องมือ ดำเนินต่อจากจุดตรวจที่ยืนยันแล้ว ก่อนเล่นซ้ำการกระทำเครื่องมือ ตรวจว่าทำเสร็จแล้วหรือไม่และปลอดภัยที่จะทำซ้ำหรือไม่ ทรานสคริปต์ที่บันทึกไว้เพียงอย่างเดียวไม่ป้องกันตั๋ว ข้อความ หรือการเขียนฐานข้อมูลซ้ำ
How Should Teams Detect Claude Sonnet 5.5 Behavior Changes Over Time?
เก็บชุดการประเมินลงวันที่พร้อมคำตอบที่ยอมรับหรือการตรวจยอมรับ รวมทั้งเวอร์ชัน SDK และการตั้งค่าคำขอ รันซ้ำเป็นระยะและหลังการเปลี่ยนผู้ให้บริการ SDK พรอมต์ หรือการจัดเส้นทาง เปรียบเทียบความสำเร็จงาน อัตราการแก้ ความหน่วง และต้นทุนรวม หากบัญชีมีการปักหมุดเวอร์ชัน ให้ยืนยันการรับประกันก่อนพึ่งพา; เก็บเส้นทางย้อนกลับสำหรับเวิร์กโฟลว์สำคัญ
