Hướng dẫn mô hình và phương thức21 tháng 10, 2026Flatkey Team

Claude Sonnet API (2026): ID mô hình, cách thiết lập, giới hạn và code cho Sonnet 5.5

Mọi thứ để gọi Claude Sonnet 5.5 qua API: ID mô hình, khóa, code chạy được, effort và chế độ suy nghĩ, giới hạn tốc độ, chi phí và cách sửa lỗi khi chuyển đổi.

Claude Sonnet API (2026): ID mô hình, cách thiết lập, giới hạn và code cho Sonnet 5.5

Để dùng Claude Sonnet API, hãy tạo một API key của Anthropic rồi gửi yêu cầu tới https://api.anthropic.com/v1/messages với ID mô hình claude-sonnet-5-5, mô hình Sonnet hiện tại, phát hành ngày 28/9/2026. Mô hình có cửa sổ ngữ cảnh 1M token, đầu ra tối đa 128K, chế độ suy nghĩ thích ứng (adaptive thinking) bật sẵn, và có giá $2 cho mỗi triệu token đầu vào, $10 cho mỗi triệu token đầu ra theo bảng giá chính thức của Anthropic tại ngày 21/10/2026. Nếu bạn chuyển code từ Sonnet 4.6 trở về trước, năm tham số từng hoạt động nay sẽ trả về lỗi 400; danh sách ở bên dưới.

Hướng dẫn này dành cho lập trình viên xây dựng sản phẩm trên Claude: nên gọi ID mô hình Sonnet nào, cách lấy khóa, code chạy được bằng curl, Python và Node.js, giới hạn tốc độ theo cấp, và các thay đổi không tương thích hay gây lỗi khi chuyển đổi. Để xem chi phí chi tiết của mọi mô hình Claude, hãy đọc hướng dẫn giá Claude API của chúng tôi.

Các mô hình Claude Sonnet có trên API

Mô hình	ID mô hình API	Trạng thái (21/10/2026)	Ngữ cảnh / đầu ra tối đa	Đầu vào / đầu ra mỗi 1M token	Đọc cache
Claude Sonnet 5.5	`claude-sonnet-5-5`	Hiện tại, phát hành 28/9/2026	1M / 128K	$2 / $10	$0.10
Claude Sonnet 5	`claude-sonnet-5`	Bản cũ (legacy)	xem tài liệu mô hình	$2 / $10	$0.20
Claude Sonnet 4.6	`claude-sonnet-4-6`	Bản cũ (legacy)	xem tài liệu mô hình	$3 / $15	$0.30
Claude Sonnet 4.5	`claude-sonnet-4-5-20250929`	Ngừng hỗ trợ, gỡ bỏ ngày 30/11/2026	xem tài liệu mô hình	$3 / $15	$0.30

Giá lấy từ trang giá của Anthropic; trạng thái mô hình từ tổng quan mô hình và trang ngừng hỗ trợ; thông số Sonnet 5.5 từ trang tổng quan Sonnet 5.5, tất cả được kiểm tra ngày 21/10/2026.

Nên gọi mô hình nào: dùng claude-sonnet-5-5 cho dự án mới. Theo hướng dẫn chuyển đổi, giá mỗi token bằng Sonnet 5 nhưng đọc cache chỉ bằng một nửa ($0.10 so với $0.20 mỗi triệu token). So với Sonnet 4.6 ($3 / $15), Sonnet 5.5 rẻ hơn tính theo token, nhưng hãy lưu ý bộ tách token: Anthropic cho biết Sonnet 5.5 tạo ra nhiều hơn khoảng 30% token so với Sonnet 4.6 cho cùng một đoạn văn bản, vì vậy hãy so sánh số token thực tế chứ không chỉ giá niêm yết. Người dùng Sonnet 4.5 phải chuyển đổi trước ngày gỡ bỏ 30/11/2026.

Tóm tắt Sonnet 5.5

Thông số	Giá trị	Nguồn
ID mô hình (Claude API, Google Cloud, Microsoft Foundry, Claude Platform on AWS)	`claude-sonnet-5-5`	Tổng quan
ID mô hình trên Amazon Bedrock	`anthropic.claude-sonnet-5-5`	Tổng quan
Cửa sổ ngữ cảnh	1M token	Tổng quan
Đầu ra tối đa	128K token; 300K trên Batch API với header beta `output-300k-2026-03-24`	Tổng quan
Dạng dữ liệu	Văn bản và hình ảnh vào, văn bản ra	Tổng quan
Suy nghĩ	Thích ứng, bật sẵn; mức thấp nhất là `between_tools`	Tổng quan
Effort mặc định	`high`	Tổng quan
Mốc kiến thức	Tháng 6/2026	Tổng quan
Gỡ bỏ	Không sớm hơn ngày 28/9/2027	Tổng quan

Cách lấy Claude Sonnet API key

Đăng nhập Claude Console và mở API keys.
Tạo khóa, sao chép một lần duy nhất và lưu dưới tên ANTHROPIC_API_KEY trong biến môi trường hoặc trình quản lý bí mật.
Nạp tín dụng hoặc thêm phương thức thanh toán. Cấp sử dụng (và giới hạn tốc độ) tăng theo mức chi tiêu; xem phần giới hạn tốc độ bên dưới.

Một khóa dùng được cho mọi mô hình Claude, nên không có "Sonnet API key" riêng. Nếu bạn muốn một khóa duy nhất cho cả Claude, GPT, Gemini và DeepSeek, một API hợp nhất như Flatkey sẽ cấp một khóa cho tất cả (xem phần cuối bài).

Yêu cầu Claude Sonnet 5.5 đầu tiên

Yêu cầu dưới đây theo ví dụ chính thức của Anthropic trong hướng dẫn chuyển đổi Sonnet 5.5. Nó đặt mức effort và tránh mọi tham số trả về lỗi 400 trên mô hình này.

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-5",
    "max_tokens": 4096,
    "messages": [{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
    "output_config": {"effort": "medium"}
  }'

Python, dùng SDK chính thức anthropic:

# pip install anthropic
import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY

response = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    messages=[{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
    output_config={"effort": "medium"},
)

print("stop_reason:", response.stop_reason)
for block in response.content:
    if block.type == "text":  # adaptive thinking may add thinking blocks first
        print(block.text)

Node.js với @anthropic-ai/sdk:

// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY

const response = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 4096,
  messages: [{ role: "user", content: "Write a SQL query that finds churned customers in the last 30 days." }],
  output_config: { effort: "medium" },
});

const text = response.content.find((b) => b.type === "text");
console.log(response.stop_reason, text?.text);

Hãy đọc phản hồi theo loại khối. Khi suy nghĩ thích ứng đang bật, khối nội dung đầu tiên có thể là khối thinking, nên đọc thẳng response.content[0].text trên Sonnet 5.5 là không an toàn.

Effort và chế độ suy nghĩ trên Sonnet 5.5

Sonnet 5.5 thay ngân sách suy nghĩ cố định bằng tham số effort trong output_config (tài liệu effort). Mặc định là high. Hướng dẫn chuyển đổi của Anthropic liệt kê các mức low, medium, high, xhigh và max.

Bạn muốn	Gửi	Ghi chú từ tài liệu Anthropic
Hành vi mặc định	không gửi gì, hoặc `thinking: {"type": "adaptive"}`	Suy nghĩ thích ứng bật sẵn
Câu trả lời rẻ và nhanh hơn	`output_config: {"effort": "low"}` hoặc `"medium"`	Effort thấp hơn nghĩa là ít token đầu ra hơn
Không suy nghĩ trước	`thinking: {"type": "between_tools"}`	Dùng được với `low`, `medium`, `high`; trả về 400 ở `xhigh` hoặc `max`
Bài toán khó nhất	`output_config: {"effort": "xhigh"}` hoặc `"max"`	Dùng suy nghĩ thích ứng, không dùng `between_tools`

Sonnet 5.5 không chấp nhận thinking: {"type": "disabled"}; between_tools là mức thấp nhất (hướng dẫn chuyển đổi).

Các tham số giờ trả về lỗi 400

Nếu nâng cấp từ Sonnet 4.6 trở về trước, hãy xóa các tham số này. Cả năm đều có trong hướng dẫn chuyển đổi Sonnet 5.5 của Anthropic:

Tham số cũ	Trên Sonnet 5.5	Thay bằng
`thinking: {"type": "enabled", "budget_tokens": N}`	Lỗi 400	`output_config.effort`
`temperature`, `top_p`, `top_k`	Lỗi 400	Chỉ dẫn trong prompt; effort
Điền trước câu trả lời (tin nhắn cuối từ `assistant`)	Lỗi 400	Đầu ra có cấu trúc hoặc chỉ dẫn hệ thống
Ép `tool_choice` (`any` hoặc một công cụ cụ thể)	Lỗi 400	`auto` kèm chỉ dẫn rõ ràng về công cụ
`thinking: {"type": "disabled"}`	Lỗi 400	`thinking: {"type": "between_tools"}`

Hãy kiểm tra lại max_tokens và ước tính chi phí vì số token tăng khoảng 30% so với Sonnet 4.6. Nếu gặp lỗi ID mô hình sau khi nâng cấp, các hướng dẫn Claude: không tìm thấy phiên bản mô hình và lỗi 400 của Anthropic của chúng tôi trình bày các nguyên nhân thường gặp.

Giới hạn tốc độ của Claude Sonnet API

Anthropic công bố giới hạn theo cấp trên trang giới hạn tốc độ. Với Sonnet 5.5, tại ngày 21/10/2026:

Cấp	Yêu cầu mỗi phút	Token đầu vào mỗi phút	Token đầu ra mỗi phút
Start	1.000	2.000.000	400.000
Build	5.000	5.000.000	1.000.000
Scale	10.000	10.000.000	2.000.000

Sonnet 5, Sonnet 4.x và Haiku 5.5 có cùng giá trị ở mỗi cấp. Anthropic lưu ý rằng với hầu hết mô hình, token đầu vào đọc từ cache không bị tính vào giới hạn token đầu vào mỗi phút, nên prompt caching vừa giúp tiết kiệm chi phí vừa giúp nới giới hạn tốc độ.

Chi phí thực tế của Sonnet 5.5

Giá chính thức tại ngày 21/10/2026, mỗi 1M token (bảng giá):

Hạng mục	Giá
Đầu vào	$2.00
Đầu ra	$10.00
Ghi cache, 5 phút	$2.50
Ghi cache, 1 giờ	$4.00
Đọc cache	$0.10
Batch API đầu vào / đầu ra	$1.00 / $5.00
Suy luận chỉ tại Mỹ (`inference_geo`)	1,1 lần mọi mức giá token

Ví dụ tính toán: một trợ lý hỗ trợ khách hàng xử lý 50.000 yêu cầu mỗi tháng, mỗi yêu cầu có system prompt đã cache 3.000 token, 500 token đầu vào mới và 400 token đầu ra. Đọc cache: 150 triệu token × $0.10 = $15. Đầu vào mới: 25 triệu × $2 = $50. Đầu ra: 20 triệu × $10 = $200. Tổng khoảng $265 mỗi tháng, chưa tính các lần ghi cache một lần. Đầu ra chiếm phần lớn, vì vậy điều chỉnh effort quan trọng hơn tối ưu đầu vào. Để so sánh từng mô hình, xem giá Claude API và định tuyến API Claude và GPT.

Dùng Claude Sonnet với OpenAI SDK

Anthropic cung cấp endpoint tương thích OpenAI tại https://api.anthropic.com/v1/, nhưng trang tương thích OpenAI SDK mô tả nó dành cho thử nghiệm và so sánh, không phù hợp với phần lớn môi trường production: tham số strict của function calling bị bỏ qua, response_format bị bỏ qua và không hỗ trợ prompt caching. Khi chạy production với Sonnet 5.5, hãy dùng Messages API gốc như trên. Bài viết về tương thích Claude API với OpenAI SDK của chúng tôi phân tích chi tiết các lựa chọn.

Một khóa cho Sonnet và các mô hình khác: Flatkey

Nếu sản phẩm của bạn cũng gọi GPT, Gemini hoặc DeepSeek, Flatkey cho bạn một khóa và một số dư trả trước cho tất cả. Ngày 21/10/2026, trang mô hình Claude Sonnet 5.5 của Flatkey niêm yết $1.60 đầu vào / $8.00 đầu ra mỗi 1M token, thấp hơn 20% so với $2 / $10 của Anthropic, và Sonnet 4.6 ở mức $2.40 / $12.00. SDK của Anthropic hoạt động chỉ bằng cách đổi base URL thành https://router.flatkey.ai (không có /v1), theo hướng dẫn Anthropic SDK của Flatkey:

import anthropic

client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Draft a release note for v2.3."}],
)
print(next(b.text for b in msg.content if b.type == "text"))

Để thiết lập Claude Code, xem cài đặt API router cho Claude Code. Hãy dùng Anthropic trực tiếp nếu bạn cần tính năng hoặc hợp đồng chỉ có trên nền tảng của họ, chẳng hạn header beta cụ thể ngay ngày ra mắt hoặc thỏa thuận doanh nghiệp.

Câu hỏi thường gặp

Tên mô hình của Claude Sonnet API là gì?

Tại ngày 21/10/2026, ID hiện tại là claude-sonnet-5-5 trên Claude API, Google Cloud, Microsoft Foundry và Claude Platform on AWS, và anthropic.claude-sonnet-5-5 trên Amazon Bedrock. Các ID cũ hơn gồm claude-sonnet-5 và claude-sonnet-4-6.

Claude Sonnet API giá bao nhiêu?

Claude Sonnet 5.5 có giá $2 mỗi triệu token đầu vào và $10 mỗi triệu token đầu ra, đọc cache $0.10 và Batch API giảm một nửa ($1 / $5), theo trang giá của Anthropic kiểm tra ngày 21/10/2026.

Claude Sonnet API có miễn phí không?

Không. API của Anthropic tính phí theo token; không có gói API miễn phí cho Sonnet. Các ứng dụng Claude dành cho người dùng cuối có gói miễn phí và trả phí riêng, tách biệt với phí API. Các lựa chọn miễn phí từ nhà cung cấp khác có trong hướng dẫn API LLM miễn phí của chúng tôi.

Cửa sổ ngữ cảnh của Claude Sonnet 5.5 là bao nhiêu?

1M token, đầu ra tối đa 128K token mỗi yêu cầu, hoặc 300K trên Message Batches API với header beta output-300k-2026-03-24.

Vì sao yêu cầu Sonnet trả về lỗi 400 sau khi nâng cấp?

Sonnet 5.5 từ chối ngân sách suy nghĩ, temperature/top_p/top_k, điền trước câu trả lời, ép chọn công cụ và thinking: {"type": "disabled"}. Hãy xóa chúng và dùng output_config.effort hoặc thinking: {"type": "between_tools"}.

Có Claude Sonnet 5 API không?

Có. claude-sonnet-5 vẫn gọi được như một mô hình cũ với giá $2 / $10 mỗi triệu token, đọc cache $0.20. Sonnet 5.5 có cùng giá token và đọc cache rẻ bằng một nửa, nên là lựa chọn mặc định tốt hơn cho dự án mới.