Claude Sonnet 5.5

Sử dụng claude-sonnet-5-5 với định dạng Anthropic Messages. Tài liệu này phân biệt đặc tả yêu cầu chính thức với hành vi quan sát được trong các bài kiểm tra tính tương thích. Một số tùy chọn nâng cao chưa hoạt động đúng đặc tả; hãy xem các giới hạn trước khi dựa vào chúng.

Xem trang mô hình để biết giá đầu vào, đầu ra và bộ nhớ đệm hiện tại.

Bắt đầu nhanh

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 chấp nhận xác thực bằng x-api-key hoặc Bearer và anthropic-version: 2023-06-01. Gửi tiêu đề anthropic-beta cho những tính năng mà tài liệu chính thức yêu cầu tiêu đề này. Giữ thông tin xác thực trong mã phía máy chủ.

Mô hình cũng chấp nhận các yêu cầu OpenAI Chat Completions (POST /v1/chat/completions) và Responses (POST /v1/responses) cơ bản. Hãy dùng Messages cho các tham số gốc được mô tả bên dưới; việc chuyển đổi định dạng OpenAI không cung cấp đầy đủ mọi tính năng của Anthropic.

Đặc tả tham số chính thức

Sonnet 5.5 có cửa sổ ngữ cảnh 1M token và giới hạn đầu ra đồng bộ là 128000 token. Các giới hạn đầu ra dành riêng cho xử lý hàng loạt không áp dụng cho điểm cuối này. Các thuộc tính tùy chọn không có giá trị mặc định do ứng dụng cung cấp, trừ khi bảng ghi rõ khác đi.

between_tools chỉ chấp nhận thuộc tính type của nó và mức nỗ lực low, medium hoặc high. Không gửi display, budget_tokens hoặc block_binding cùng chế độ này. Ví dụ:

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

Không hỗ trợ điền sẵn nội dung trợ lý. Để tiếp tục một pause_turn, hãy gửi lại nguyên vẹn nội dung trợ lý có công cụ phía máy chủ đã được trả về. Nén ngữ cảnh tóm tắt lịch sử hiện có và không phải là điền sẵn nội dung trợ lý. Giữ nguyên các khối suy luận và chữ ký; không chuyển chúng giữa các mô hình hoặc chỉnh sửa lịch sử trước đó mà không tuân theo quy tắc liên kết chính thức.

Trên API gốc của Claude, việc sử dụng máy tính yêu cầu computer_toolset_20260801; computer_20251124 bị từ chối. Các cấu hình cố vấn dùng claude-opus-4-8, claude-opus-4-7 hoặc claude-sonnet-5 cũng bị từ chối đối với bộ thực thi này.

Các trường yêu cầu dự phòng

Tính năng beta fallbacks chính thức thử lại những lần từ chối đủ điều kiện do bộ phân loại đưa ra. Tính năng này không thử lại khi gặp giới hạn tốc độ, quá tải hoặc lỗi máy chủ, và một lần từ chối có thể vẫn không được giải quyết. Gửi server-side-fallback-2026-07-01 cho "default" hoặc danh sách tường minh; server-side-fallback-2026-06-01 chỉ hỗ trợ danh sách. Các phiên bản mang ngày khác bị từ chối.

Một danh sách tường minh chứa tối đa ba mục với các mô hình khác nhau, không mô hình nào trùng với mô hình được yêu cầu. Các mô hình đích được phép lấy từ allowed_fallback_models của Models API beta. Mỗi mục chỉ cho phép model, max_tokens, thinking, output_config và speed; các giá trị ghi đè phải hợp lệ với mô hình đích đó. Bản beta tháng Bảy chuyển between_tools của Sonnet 5.5 thành disabled của Sonnet 5, với phần hiển thị bị lược bỏ, khi chuyển sang mô hình dự phòng đó. Với bản beta tháng Sáu, bạn phải tự cung cấp giá trị ghi đè cho suy luận của Sonnet 5.

fallback_credit_token dành cho một lần thử lại riêng sau khi bị từ chối. Chuỗi chọn cách sử dụng khoản tín dụng theo chế độ nghiêm ngặt; đối tượng bổ sung mode. Trong chế độ strict, nếu không sử dụng được khoản tín dụng thì lần thử lại bị từ chối. Trong chế độ best_effort, khi có lỗi ở lớp token, yêu cầu có thể tiếp tục với mức giá thông thường và lỗi được ghi nhận trong usage.fallback_credit; token sai định dạng và việc kết hợp khoản tín dụng với fallbacks vẫn thất bại. Việc sử dụng khoản tín dụng còn yêu cầu điều kiện phù hợp về yêu cầu, tài khoản, không gian làm việc, nền tảng và khoảng thời gian năm phút như mô tả trong hướng dẫn chính thức về khoản tín dụng.

Một yêu cầu có nội dung lành tính với fallbacks: "default", tiêu đề beta tháng Bảy và speed: "standard" đã trả về văn bản như mong đợi. Điều này chỉ xác nhận việc chấp nhận yêu cầu: việc thực thi dự phòng và sử dụng khoản tín dụng chưa được xác minh từ đầu đến cuối tại đây.

Đầu vào đa phương tiện và công cụ

Hình ảnh dùng khối image và PDF dùng khối document trong tin nhắn của người dùng. Các kiểu nguồn chính thức bao gồm URL công khai và base64 với kiểu MIME tương ứng. Các bài kiểm tra tính tương thích đã dùng PNG ở dạng base64 và PDF một trang ở dạng base64, đồng thời xác minh nội dung câu trả lời. Các bài kiểm tra này chưa kiểm tra mọi giới hạn liên quan đến URL, kích thước tệp, độ phân giải hình ảnh hoặc số trang PDF.

Công cụ phía máy khách dùng quy trình trao đổi tool_use → tool_result tiêu chuẩn. Giữ nguyên ID sử dụng công cụ và trả lại kết quả trong tin nhắn của người dùng. Một ví dụ công cụ ở chế độ nghiêm ngặt thành công xác minh các đối số của chính ví dụ đó, không phải mọi từ khóa JSON Schema được hỗ trợ.

Phản hồi

Phản hồi không truyền phát chứa id, type: "message", role: "assistant", model, content, stop_reason, stop_sequence và usage, cùng các trường chính thức tùy chọn như container, diagnostics, context_management, stop_details và các trường phản hồi beta. Nội dung có thể bao gồm văn bản, suy luận, lệnh gọi công cụ, kết quả công cụ hoặc các kiểu khối chính thức khác; đừng mặc định khối đầu tiên là văn bản.

Khi truyền phát, hãy xử lý message_start, content_block_start, content_block_delta, content_block_stop, message_delta và message_stop. Lỗi cũng có thể xảy ra trong luồng. Mức sử dụng có thể bao gồm token đầu vào/đầu ra thông thường, chi tiết token suy luận, lượt đọc bộ nhớ đệm và số lượng tạo bộ nhớ đệm riêng cho 5 phút / 1 giờ.

Một lần từ chối chính thức do bộ phân loại đưa ra là phản hồi bình thường với stop_reason: "refusal" và stop_details, không phải lỗi HTTP. Trong phản hồi dự phòng, model xác định mô hình đã trả lời, các khối nội dung fallback đánh dấu các lần chuyển đổi và usage.iterations mô tả các lần thử. Hãy kiểm tra các trường này thay vì mặc định mô hình được yêu cầu đã trả lời. Những hành vi phản hồi này vẫn chưa được xác minh tại đây.

Lỗi Messages dùng {"type":"error","error":{"type":"...","message":"..."}}. Các yêu cầu thất bại không bị tính phí.

Xác minh tính tương thích: 2026-10-01

Việc thực thi công cụ beta, kết nối MCP thực tế, tham chiếu Files API, vị trí địa lý lưu trú dữ liệu, gửi lại chữ ký suy luận, toàn bộ giới hạn tối đa của ngữ cảnh/đầu ra, các trường hợp biên của đa phương tiện và hành vi từ chối/dự phòng chưa được xác minh từ đầu đến cuối. HTTP 200 và tên mô hình được trả về không xác thực mô hình nào đã chạy hoặc chứng minh mọi tùy chọn được gửi đều có tác dụng.

Tài liệu tham khảo

• Tổng quan chính thức về Sonnet 5.5
• Thay đổi và hạn chế của Sonnet 5.5
• Tài liệu tham số Messages
• Mức nỗ lực cho từng tin nhắn
• Nén ngữ cảnh theo yêu cầu
• Từ chối và dự phòng
• Khoản tín dụng dự phòng
• Lược đồ OpenAPI
• Markdown có thể sao chép