Claude Haiku 5.5 and Nano Banana 2.1 are now live on CometAPI →
technology/Nghiên cứu CometAPI

Cách sử dụng API Claude Sonnet 5.5

Tìm hiểu cách sử dụng Claude Sonnet 5.5 API với CometAPI bằng cURL, Python và JavaScript. Khám phá Messages API, truy cập tương thích với OpenAI, truyền phát theo luồng, thị giác.

CometAPI
Deon GoodwinĐội ngũ nghiên cứu mô hình AI và API
Đã cập nhật Oct 13, 2026 24 phút đọc
Cách sử dụng API Claude Sonnet 5.5
Sử dụng mẫu này

Thực hiện API call đầu tiên.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_COMETAPI_KEY",
    base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "Build this workflow."}],
)

print(response.choices[0].message.content)

TL;DR

Claude Sonnet 5.5 là một mô hình nhanh cho các quy trình công việc mã hóa phạm vi rõ ràng, tài liệu và sử dụng công cụ. Anthropic báo cáo tốc độ xuất đầu ra nhanh hơn hơn 30% so với Sonnet 5 ở cùng mức giá token tiêu chuẩn. Bắt đầu với khóa CometAPI, model ID claude-sonnet-5-5, và một yêu cầu Messages hoặc Chat Completions nhỏ. Các agent hiện có nên kiểm thử lại phần “thinking”, lựa chọn công cụ và phát lại lịch sử trước khi triển khai.

Key Takeaways

  • Sử dụng Claude Sonnet 5.5 và khớp định dạng yêu cầu với endpoint của bạn.
  • Bắt đầu với một yêu cầu ngắn trước khi thêm hình ảnh, công cụ hoặc ngữ cảnh dài.
  • Dùng Messages cho các điều khiển đặc thù Claude; dùng Chat Completions cho ứng dụng đang sử dụng OpenAI SDK.
  • Rà soát thay đổi về “thinking” và lựa chọn công cụ trước khi di trú vòng lặp agent hiện có.
  • So sánh chất lượng tác vụ được chấp nhận, độ trễ, mức dùng token và cache hits trước khi mở rộng lưu lượng.

What Is Claude Sonnet 5.5?

Claude Sonnet 5.5 API là giao diện lập trình cho mô hình Sonnet 5.5 của Anthropic. Nó được thiết kế cho các tác vụ như phát triển phần mềm, phân tích repository, tự động hóa hỗ trợ khách hàng, xử lý tài liệu, hiểu hình ảnh, agent sử dụng công cụ và các quy trình chuyên nghiệp có cấu trúc.

Anthropic định vị Sonnet 5.5 là một bổ sung nhanh hơn, chi phí thấp hơn cho Opus 5.5, mô hình thứ hai trong gia đình Claude 5.5, được tối ưu cho mã hóa phạm vi rõ ràng, sửa lỗi, tạo tài liệu và slide, và các tác vụ chuyên môn hằng ngày. Nhà phát triển có thể truy cập Claude Sonnet 5.5 API trong CometAPI với claude-sonnet-5-5.

SpecificationClaude Sonnet 5.5
ProviderAnthropic
Model IDclaude-sonnet-5-5
Release date28 tháng 9, 2026
Context window1M tokens
Maximum synchronous output128K tokens
Batch maximum outputTối đa 300K tokens trong cấu hình beta được hỗ trợ
InputsVăn bản, hình ảnh
OutputVăn bản
ThinkingTư duy thích ứng
Default Claude API effortCao
Knowledge cutoffTháng 6 năm 2026
Input price (Anthropic / CometAPI)$2.00 / $1.60 mỗi 1M tokens
Output price (Anthropic / CometAPI)$10.00 / $8.00 mỗi 1M tokens

Anthropic xác nhận cửa sổ ngữ cảnh 1M token và giới hạn đầu ra đồng bộ 128K. Đầu ra theo lô có thể đạt 300K tokens chỉ thông qua Message Batches với header beta output-300k-2026-03-24. Cần kiểm tra hỗ trợ tính năng Gateway riêng biệt với hỗ trợ cấp độ model.

How Does Claude Sonnet 5.5 Perform on Official Benchmarks?

Bảng so sánh gọn dưới đây giúp xác định các tác vụ nên đánh giá trước khi áp dụng API. Kết quả benchmark không thay thế cho việc thử nghiệm prompt và vòng lặp công cụ của riêng bạn.

BenchmarkClaude Sonnet 5.5Claude Sonnet 5Claude Opus 5.5
Terminal-Bench 4.070.6%10.3%66.4% ở mức Xhigh
FrontierCode 1.1 Main46.2% ở Max / 52.1% ở Xhigh42.4%54.4%
CursorBench 4.055.5%34.1%57.8%
GDPval-AA v2.1184414491846
OSWorld 2.1, partial80.1%57.0%81.8%
AA-Briefcase v1.1181113591822
Humanity’s Last Exam, with tools64.5%54.9%67.7%
Chartography, no tools61.6%15.6%64.4%

Kết quả benchmark và ghi chú đánh giá của Anthropic là cơ sở cho so sánh này. Kết quả Terminal-Bench của Opus 5.5 dùng effort Xhigh; FrontierCode báo cáo riêng kết quả Max và Xhigh cho Sonnet 5.5; OSWorld là đánh giá một phần. GDPval-AA và AA-Briefcase do Artificial Analysis chạy trên triển khai Claude Platform tiền phát hành với lỗi structured-output có thể khiến điểm của Sonnet 5.5 thấp hơn; Anthropic cho biết lỗi đã được sửa. Những kết quả này nên dẫn hướng thử nghiệm tác vụ hơn là bảo đảm kết quả sản xuất. Humanity’s Last Exam dùng công cụ; Chartography thì không. Các dòng mới dùng điểm đã công bố của Anthropic. Ảnh gốc bên dưới được giữ lại; bảng mở rộng bao gồm ba đánh giá bổ sung.

Cách sử dụng API Claude Sonnet 5.5

So sánh benchmark chính thức của Claude Sonnet 5.5

What Changed in Claude Sonnet 5.5 API From Sonnet 5?

DimensionClaude Sonnet 5.5Migration impact
Output speedTốc độ tạo đầu ra nhanh hơn 30%+ (theo báo cáo)Chuẩn hóa lại độ trễ
Official token ratesCùng mức $2 đầu vào / $10 đầu ra mỗi MTokSo sánh tổng chi phí tác vụ
Lowest thinking settingbetween_tools thay cho disabledCập nhật cấu hình “thinking”
Forced tool choiceTừ chối ép buộc “any” hoặc chỉ định theo tênDùng auto; sắp xếp các bước bắt buộc trong mã
Thinking historyKý theo hội thoại và tài khoảnBảo tồn các block và lịch sử ổn định
Computer use compatibilitycomputer_20251124 bị từ chối trên Claude API / Google CloudDi trú sang computer_toolset_20260801; xác minh hỗ trợ gateway
Advisor model compatibilityCác cặp advisor trước đó bị từ chốiChọn advisor được hỗ trợ, chẳng hạn Opus 5.5

Các thay đổi về “thinking”, lựa chọn công cụ và phát lại lịch sử ảnh hưởng đến vòng lặp agent hiện có. Bảng tóm tắt các thay đổi vận hành; đây không phải là danh mục tính năng đầy đủ.

Breaking Changes to Check

Kiểm tra cả năm thay đổi phá vỡ: thay disabled thinking bằng between_tools; bỏ bắt buộc chọn công cụ; bảo tồn các block thinking tương thích và lịch sử hội thoại không đổi; di trú từ computer_20251124 sang computer_toolset_20260801 trên Claude API và Google Cloud; và thay các cặp advisor không được hỗ trợ. Amazon Bedrock vẫn chấp nhận computer_20251124. Advisor không được hỗ trợ gồm Opus 4.8, 4.7, 4.6, Sonnet 5, Sonnet 4.6 và Haiku 5.5. Opus 5.5 là một lựa chọn thay thế được hỗ trợ. Đọc các block phản hồi theo loại. Xác minh tính tương thích nền tảng và gateway trước khi triển khai.

Additional Capabilities and Workflow Changes

Dùng hướng dẫn tính năng chính thức để xem cập nhật tiến độ, effort theo từng tin nhắn và điều khiển giữa hội thoại. Xác nhận hỗ trợ gateway trước khi bật tính năng beta.

What Do You Need Before Using the Claude Sonnet 5.5 API?

  • Tài khoản CometAPI, khóa API, quyền truy cập model và số dư thanh toán khả dụng.
  • Một terminal với cURL; Python và pip hoặc Node.js và npm cho ví dụ SDK.
  • Endpoint đã chọn: /v1/messages hoặc /v1/chat/completions.
  • COMETAPI_KEY được lưu trong môi trường máy chủ, cùng quyền truy cập mạng tới https://api.cometapi.com.
  • Một prompt thử ngắn và bước kiểm tra rõ ràng cho đầu ra dùng được, trạng thái hoàn thành và mức dùng token.

How Do You Access Claude Sonnet 5.5 API Through CometAPI?

API styleEndpointBest for
Claude-native Messages APIPOST /v1/messagesCông cụ đặc thù Claude, điều khiển “thinking”, quy trình agent, cấu trúc phản hồi Anthropic
OpenAI-compatible Chat CompletionsPOST /v1/chat/completionsDự án dùng OpenAI SDK sẵn có, bộ định tuyến model, ứng dụng đa model

Chọn Messages API khi hành vi của Claude bản thân là quan trọng. Chọn OpenAI-compatible API khi ứng dụng của bạn đã chuyển đổi giữa Claude, GPT, Gemini, DeepSeek hoặc các model khác qua cùng lớp trừu tượng.

Step 1: Store the API Key

Tạo khóa trong bảng điều khiển khóa API của CometAPI, rồi thiết lập trong môi trường runtime.

Đặt khóa CometAPI trong shell POSIX

export COMETAPI_KEY="YOUR_COMETAPI_KEY"

Đặt khóa CometAPI trong PowerShell

$env:COMETAPI_KEY="YOUR_COMETAPI_KEY"

Step 2: Make the First Messages Request

Gửi yêu cầu Messages tương thích Anthropic đầu tiên

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."}]
  }'

Kiểm tra các content block, stop_reason và usage trước khi thêm nhiều điều khiển hơn. Cú pháp cURL trên dùng shell POSIX.

Step 3: Use the Anthropic Python SDK

Cài đặt Anthropic Python SDK

pip install anthropic

Đọc text block và usage với 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

Cài đặt OpenAI Python SDK

pip install openai

Gọi Sonnet 5.5 qua 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)

Cách tiếp cận này hữu ích khi ứng dụng đã dùng giao diện OpenAI SDK. Một tích hợp văn bản cơ bản có thể chỉ cần URL cơ sở mới, khóa API và model ID, nhưng di trú sản xuất vẫn cần xác minh tham số được hỗ trợ, định dạng phản hồi, gọi công cụ, sự kiện streaming, timeout và tính toán token.

Step 5: Use JavaScript in Node.js

Cài đặt OpenAI Node.js SDK

npm install openai

Gọi Sonnet 5.5 từ 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);

Với ứng dụng Node.js backend, giữ COMETAPI_KEY trong môi trường máy chủ thay vì gửi tới trình duyệt.

Claude Sonnet 5.5 Thinking and Effort Levels

API mặc định ở mức effort cao; các ứng dụng Claude và Claude Code dùng mức trung bình. Chọn effort dựa trên chất lượng tác vụ được chấp nhận, độ trễ và chi phí token. Bảng dưới đây là gợi ý biên tập khởi đầu, không phải phân loại chính thức.

WorkloadSuggested starting effort
Trích xuấtThấp
Phân loạiThấp
Phản hồi hỗ trợ thường lệThấp hoặc Trung bình
Giải thích mãTrung bình
Sửa lỗiTrung bình
Mã hóa cấp repositoryCao
Quy trình agent phức tạpCao
Rà soát sản xuất đắt đỏCao, rồi so sánh với Opus
Mã hóa/agent đòi hỏi, tầm nhìn dàiXhigh, chỉ khi đánh giá cho thấy chất lượng tăng
Hầu hết tác vụ nhạy năng lực với ngân sách chấp nhận đượcMax, chỉ khi đánh giá biện minh độ trễ và token bổ sung

Tránh tự động đặt mức effort cao nhất cho mọi yêu cầu. Tác vụ agent có thể tốn kém đáng kể khi lập luận bổ sung cũng tạo thêm gọi công cụ và đầu ra dài hơn. Chọn mức phù hợp theo từng tác vụ. Dùng tư duy thích ứng (adaptive) cho Xhigh và Max, rồi so sánh chất lượng tác vụ được chấp nhận và tổng chi phí với mức thấp hơn. Hướng dẫn effort chính thức.

Configure Effort Through Messages

Ví dụ này dùng Anthropic client đã khởi tạo ở trên. Kiểm thử cùng điều khiển trên route CometAPI của bạn trước khi triển khai.

Cấu hình tư duy thích ứng và effort cao

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

Dùng thinking={"type": "between_tools"} ở mức thấp, trung bình hoặc cao. Dùng tư duy thích ứng cho xhigh hoặc max. between_tools không có trường display hoặc budget_tokens và không cho phép thay đổi effort giữa hội thoại.

Preserve Thinking in Tool Loops

Trả lại các content block ban đầu của assistant trước khi bổ sung kết quả công cụ. Việc bảo tồn thinking phụ thuộc vào model, tiền tố hội thoại và tài khoản tạo. Ràng buộc tiền tố (prefix binding) được cưỡng bức theo mặc định trên Claude API, Amazon Bedrock và Google Cloud cho các tài khoản tạo vào hoặc sau 31 tháng 8, 2026, 00:00 UTC. Không nên giả định mọi gateway đều phơi lộ cùng điều khiển ràng buộc.

How to Stream Claude Sonnet 5.5 Responses

Stream Long Responses

Streaming hữu ích cho giao diện chat, trợ lý mã hóa và phản hồi dài vì người dùng thấy đầu ra trước khi tạo xong.

Stream văn bản qua 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)

Streaming thường không giảm tổng số token được tạo. Lợi ích chính là giảm độ trễ cảm nhận. Ứng dụng cũng nên xử lý luồng bị gián đoạn, đầu ra một phần, thử lại mạng và hủy bỏ một cách tường minh.

Use Tools With Automatic Selection

Dùng tool_choice={"type": "auto"}. Xác thực mọi tên công cụ và tham số, áp dụng ủy quyền và timeout, trả kết quả có cấu trúc, và giới hạn số vòng lặp. Việc thực thi công cụ bắt buộc nên thuộc về điều phối ứng dụng.

Định nghĩa công cụ tra cứu ticket và yêu cầu chọn tự động

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."}],
)

Một block tool_use yêu cầu hành động; lần gọi đầu tiên này không thực thi. Hãy xác thực yêu cầu trên máy chủ của bạn, chạy thao tác, nối thêm nội dung assistant không đổi, và gửi tool_result tương ứng. Schema trong ví dụ vẫn cần xác thực phía ứng dụng; hỗ trợ công cụ nghiêm ngặt nên được kiểm tra trên route đã chọn.

Use Prompt Caching for Repeated Context

Prompt caching hữu ích khi các yêu cầu lặp lại cùng tiền tố lớn, như chính sách hệ thống, schema công cụ, bản đồ repository, tài liệu sản phẩm, hướng dẫn tái sử dụng hoặc sổ tay tham chiếu.

Sonnet 5.5 yêu cầu tiền tố có thể cache tối thiểu 512 token. Tiền tố ngắn hơn sẽ được xử lý không dùng cache, kể cả khi có cache_control. Kiểm tra cache_creation_input_tokens và cache_read_input_tokens; cả hai bằng 0 nghĩa là không dùng cache. Xác nhận hỗ trợ trên route gateway của bạn. Tài liệu prompt caching.

Sắp xếp ngữ cảnh ổn định trước nội dung yêu cầu động

Stable system instructions
Stable tools
Stable repository or knowledge context
---------------- cache boundary ----------------
Current user request
Current retrieved context

Mức phí cache-read hiện tại của CometAPI là $0.16 mỗi triệu token, so với $1.60 cho đầu vào mới. Ghi cache được tính phí riêng. Xác minh cache hit trong metadata usage trước khi ước tính tiết kiệm.

Caching đặc biệt hữu ích cho agent mã hóa và trợ lý doanh nghiệp tái sử dụng tiền tố ngữ cảnh lớn xuyên suốt các lượt. Hiệu quả kinh tế vẫn phụ thuộc vào cache hit thực tế; viết lại tiền tố ổn định thường xuyên có thể loại bỏ phần lớn kỳ vọng lợi ích.

Send Images Using the Selected Endpoint Schema

Sonnet 5.5 chấp nhận đầu vào văn bản và hình ảnh. JSON dưới đây là payload OpenAI-compatible Chat Completions; thay URL hình ví dụ bằng URL công khai bạn kiểm soát. Messages dùng schema image-block khác.

Gửi hình ảnh trong 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"
          }
        }
      ]
    }
  ]
}

Hình thức yêu cầu đa phương thức có thể khác nhau giữa giao diện Claude-native và OpenAI-compatible, vì vậy hãy dùng schema của endpoint bạn triển khai thay vì giả định hai định dạng thay thế cho nhau.

Handle Safeguards and Retained Data

Ghi nhận việc từ chối và hành vi fallback như các trạng thái ứng dụng tường minh. Anthropic mô tả các biện pháp bảo vệ và chế độ không lưu dữ liệu cho dịch vụ của họ. Xác minh thỏa thuận lưu trữ và định tuyến áp dụng của gateway của bạn riêng biệt trước khi gửi tài liệu sản xuất.

Claude Sonnet 5.5 vs Sonnet 5 vs Opus 5.5

Các nhãn định tính dưới đây là hướng dẫn định tuyến mang tính biên tập dựa trên phạm vi tác vụ, không phải điểm năng lực chính thức. Hãy xác thực vai trò này trên tải công việc đại diện. Không suy diễn kiến trúc chi tiết từ điểm benchmark.

DimensionClaude Sonnet 5Claude Sonnet 5.5Claude Opus 5.5
Mã hóa thường lệMạnhMạnh hơn và nhanh hơnThường không cần
Công việc cấp repositoryMạnhRất mạnhPhù hợp nhất cho ca khó
Agent phạm vi rõ ràngMạnhPhù hợp chínhHữu ích cho quy trình khó hơn
Công việc mơ hồ, dài hạnTốtRất tốtPhù hợp chính
Tốc độ đầu raChuẩnNhanh hơn 30%+ so với Sonnet 5Tối ưu nhiều hơn cho năng lực thay vì thông lượng rẻ
Đầu vào chính thức$2/M$2/M$4/M
Đầu ra chính thức$10/M$10/M$20/M
Vai trò sản xuất điển hìnhTác vụ Sonnet hiện cóỨng viên Sonnet mặc địnhTầng thang cấp / độ phức tạp cao
Cửa sổ ngữ cảnh1M tokens1M tokens1M tokens
Đầu vào / đầu raVăn bản và hình ảnh / văn bảnVăn bản và hình ảnh / văn bảnVăn bản và hình ảnh / văn bản
ThinkingThích ứngThích ứng; between_tools ở mức cao hoặc thấp hơnThích ứng, luôn bật
API availabilityTích hợp CometAPI hiện cóCometAPI Messages và Chat Completions tương thíchCó qua CometAPI

Chuyển các tác vụ khó đến mô hình thang cấp

Routine task
    ↓
Claude Sonnet 5.5
    ↓
Confidence / validation failure?
    ├── No → Return result
    └── Yes → Escalate difficult case
                 ↓
              Opus-class model

Mẫu định tuyến này có thể giảm chi phí trong khi vẫn giữ quyền truy cập vào tầng lập luận mạnh hơn cho các ca khó.

Claude Sonnet 5.5 Pricing Through CometAPI

Pricing typeAnthropicCometAPI
Input$2.00 / 1M tokens$1.60 / 1M tokens
Output$10.00 / 1M tokens$8.00 / 1M tokens
Cache read$0.10 / 1M tokens$0.16 / 1M tokens
Cache write (5-minute TTL)$2.50 / 1M tokens$2.00 / 1M tokens

Đã kiểm tra ngày 10 tháng 10, 2026: CometAPI input/output vẫn là $1.60/$8 mỗi triệu token, thấp hơn 20% so với mức $2/$10 của Anthropic. CometAPI cache read/write vẫn là $0.16/$2; mức hiện tại của Anthropic cho cache read/write là $0.10/$2.50 với thời hạn ghi 5 phút. Trang ra mắt vẫn hiển thị cache read $0.20; bản cập nhật này dùng tài liệu caching hiện tại. Giá gateway có thể thay đổi độc lập.

Chênh lệch giữa giá token và chi phí tác vụ quan trọng đối với ứng dụng agent. Một agent mã hóa có thể tạo ít token hơn nhưng vẫn thực hiện nhiều vòng gọi công cụ, đọc cache, kiểm tra mã, thử lại và xác thực. Chi phí trên mỗi tác vụ hoàn thành thành công vì vậy thường thông tin hơn so với chỉ giá token đầu vào.

Ước tính phí đầu vào mới và token đầu ra

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

Phí công cụ, thao tác cache, bước agent lặp lại hoặc tính năng tính phí khác có thể thay đổi chi phí cuối cùng.

Đã kiểm tra lại mức ngày 10 tháng 10, 2026 so với trang model hiện tại của CometAPI. Giá đầu vào/đầu ra mới không đổi, nên ví dụ vẫn là $0.16 + $0.04 = $0.20 cho 100,000 đầu vào mới và 5,000 token đầu ra. Không bao gồm ghi/đọc cache, phí công cụ và thử lại. Hãy kiểm tra lại tính cước theo route trước khi lập ngân sách.

Control Cost per Accepted Task

Có vài cách thực tế để giảm chi tiêu mà chưa cần đổi model. Thứ nhất, định nghĩa rõ tiêu chí hoàn thành:

Định nghĩa định dạng chấp nhận phản hồi tập trung

Return only:
1. the root cause;
2. the affected file;
3. the smallest safe fix;
4. one regression test.

Thứ hai, cắt gọn ngữ cảnh truy hồi trước khi gửi. Cửa sổ ngữ cảnh 1M token là giới hạn năng lực, không phải mục tiêu. Thứ ba, tái sử dụng ngữ cảnh ổn định qua prompt caching. Thứ tư, chọn effort theo loại tác vụ thay vì đặt Cao cho mọi yêu cầu. Thứ năm, đo chi phí trên mỗi tác vụ được chấp nhận:

Tính chi phí trên mỗi tác vụ được chấp nhận

Total API cost
÷
Number of outputs accepted without rework

Một yêu cầu rẻ hơn không nhất thiết là quy trình rẻ hơn nếu nó gây thêm thử lại, chỉnh sửa hoặc gọi công cụ.

How Do You Migrate From Sonnet 5 to Claude Sonnet 5.5 API?

  1. Giữ cấu hình sản xuất trước đó để có thể rollback.
  2. Đổi model ID từ claude-sonnet-5 sang claude-sonnet-5-5.
  3. Áp dụng các thay đổi về “thinking”, lựa chọn công cụ và lịch sử như đã mô tả.
  4. Phát lại các yêu cầu đại diện, bao gồm công cụ, hình ảnh và streaming.
  5. So sánh đầu ra được chấp nhận, tỉ lệ sửa của con người, p50/p95 latency và tổng chi phí tác vụ.
  6. Kiểm thử thử lại, từ chối, hủy bỏ và luồng bị gián đoạn.
  7. Xác minh cache hit và hành vi ngân sách đầu ra từ metadata usage.
  8. Phát hành canary lưu lượng nhỏ và chỉ mở rộng sau khi vượt ngưỡng chấp nhận.

Troubleshooting Claude Sonnet 5.5 API Errors

SymptomWhat to check
400: invalid thinking settingThay disabled bằng between_tools ở mức cao hoặc thấp hơn; dùng adaptive cho xhigh/max.
400: forced tool selectionBỏ bắt buộc chọn công cụ “any” hoặc chỉ định theo tên; dùng auto.
400 after replaying historyVới tài khoản áp dụng ràng buộc tiền tố, giữ thinking đã ký và lịch sử trước đó không đổi; kiểm tra tương thích model/tài khoản và route đã chọn.
401 / 403Kiểm tra thông tin xác thực, quyền và truy cập model.
429 / retryable 5xxDùng backoff hàm mũ có jitter trong giới hạn và tôn trọng Retry-After khi được cung cấp.
Response contains no ordinary textKiểm tra loại nội dung, trạng thái hoàn thành, từ chối và hành vi fallback.
Output ends earlyKiểm tra stop_reason hoặc finish_reason; điều chỉnh ngân sách đầu ra và dùng streaming.
Cache never hitsKiểm tra tiền tố ổn định và metadata sử dụng cache.
Stream disconnectsGiữ lại đầu ra một phần và thử lại theo quy tắc idempotency của ứng dụng.

Không thử lại các yêu cầu sai định dạng hoặc lỗi xác thực mà không thay đổi. Ngăn hành động công cụ trùng lặp khi phát lại các lần chạy agent bị gián đoạn.

Claude Sonnet 5.5 Production Best Practices

Chọn một loại tác vụ, định nghĩa cổng chấp nhận và đánh giá toàn bộ ứng dụng. Ghi log model ID, endpoint, effort, độ trễ, mức dùng token và cache, lỗi công cụ, trạng thái hoàn thành và kết quả tác vụ được chấp nhận. Giữ khóa phía máy chủ và cấu hình timeout, thử lại có giới hạn và giới hạn số vòng agent.

Measure Workflow Quality and Reliability

MetricWhy it matters
Tỉ lệ hoàn thành tác vụĐo lường việc hoàn tất quy trình thực tế
Tỉ lệ chỉnh sửa của con ngườiBộc lộ vấn đề chất lượng tiềm ẩn
Token đầu vàoKiểm soát chi phí ngữ cảnh
Token đầu raKiểm soát chi phí tạo sinh
Tỉ lệ cache hitXác định giá trị caching
Số lần gọi công cụPhát hiện agent kém hiệu quả
Gọi công cụ không hợp lệĐo độ tin cậy điều phối
Tỉ lệ thử lạiBộc lộ sự bất ổn của API/quy trình
p50 latencyTrải nghiệm điển hình
p95 latencyTrải nghiệm đuôi dài
Chi phí trên tác vụ được chấp nhậnKết nối giữa chất lượng và kinh tế

Với agent mã hóa, cũng theo dõi số bài test vượt, file bị sửa không cần thiết, patch bị revert và hoàn thành thành công không cần can thiệp.

Example: Fix a Well-Scoped Repository Bug

Cung cấp bài test lỗi, file nguồn liên quan và hành vi kỳ vọng. Yêu cầu patch tập trung kèm kiểm tra hồi quy. Cổng chấp nhận là bản sửa tái lập được, vượt qua test liên quan và không có chỉnh sửa không liên quan. So sánh tổng chi phí API và công cụ với patch được chấp nhận.

Example: Triage a Support Ticket

Truy xuất vấn đề của khách hàng và các đoạn KB đã phê duyệt. Yêu cầu model phân loại vấn đề, soạn phản hồi có chứng cứ và gắn cờ trường hợp cần thang cấp. Chỉ chấp nhận kết quả khi các khẳng định khớp tài liệu truy xuất và quyết định định tuyến theo đúng chính sách hỗ trợ.

Example: Review a Document and Screenshot

Cung cấp quy trình đã phê duyệt và ảnh chụp màn hình giao diện tương ứng. Yêu cầu chỉ ra sai khác với tham chiếu tới đoạn phù hợp và phần tử UI hiển thị. Yêu cầu người rà soát xác nhận phát hiện trước khi thay đổi quy trình.

Conclusion

Claude Sonnet 5.5 mang đến cho các đội nhóm một ứng viên thực tế cho quy trình mã hóa, hỗ trợ, tài liệu và sử dụng công cụ nhanh. Bắt đầu với yêu cầu CometAPI hoạt động, rồi thêm các điều khiển mà ứng dụng của bạn cần.

Di trú đòi hỏi nhiều hơn là thay model ID: kiểm tra thiết lập “thinking”, tự động chọn công cụ, phân tích phản hồi và phát lại lịch sử. Thăng hạng model khi đánh giá tác vụ của bạn cho thấy cân bằng chấp nhận được giữa chất lượng, độ trễ và chi phí; dành một tầng mạnh hơn cho các tác vụ không vượt qua cổng chấp nhận.

FAQ

How Should Teams Rotate a Claude Sonnet 5.5 API Key Without Downtime?

Lưu khóa trong bộ quản lý bí mật phía máy chủ và để các worker nạp lại thông tin xác thực mà không nhúng vào mã ứng dụng. Nếu nhà cung cấp hỗ trợ chồng lấp khóa hoạt động, giới thiệu khóa thay thế trước, xác thực yêu cầu nhỏ, chuyển dần worker, rồi thu hồi khóa trước đó. Giám sát lỗi xác thực trong quá trình thay đổi và tránh log bất kỳ khóa nào.

How Can a Claude Sonnet 5.5 Job Resume After a Worker Restart?

Lưu trữ mã định danh job, bước hoàn thành gần nhất, cấu hình yêu cầu và bản ghi thực thi công cụ. Tiếp tục từ checkpoint đã xác minh. Trước khi phát lại hành động công cụ, kiểm tra xem nó đã hoàn thành chưa và có an toàn để lặp lại hay không. Một transcript được lưu một mình không ngăn trùng lặp ticket, tin nhắn hoặc ghi database.

How Should Teams Detect Claude Sonnet 5.5 Behavior Changes Over Time?

Giữ một bộ đánh giá có ngày tháng với câu trả lời được chấp nhận hoặc kiểm tra chấp nhận, cùng phiên bản SDK và thiết lập yêu cầu. Chạy lại định kỳ và sau các thay đổi về nhà cung cấp, SDK, prompt hoặc định tuyến. So sánh tỉ lệ thành công tác vụ, tỉ lệ chỉnh sửa, độ trễ và tổng chi phí. Nếu tài khoản cung cấp khả năng ghim phiên bản, xác nhận cam kết của nó trước khi phụ thuộc; giữ route rollback cho quy trình quan trọng.

Tiếp tục học

Kết nối bài viết này với quyết định tiếp theo.

Xem tất cả chủ đề
Được xuất bản Oct 13, 2026
Cập nhật lần cuối Oct 13, 2026
0 lượt xem
Đã được xem xét về độ rõ ràng, ghi nguồn và thuật ngữ API hiện tại.

Đọc thêm