Khác biệt tham số và giao thức của Claude

Tìm hiểu khác biệt tham số và cách dùng mô hình Claude qua các giao thức tương thích.

Claude gốc dùng Messages. Với Chat Completions, xem giới hạn lớp tương thích Anthropic bên dưới; chuyển đổi nền tảng theo đầu vào mô hình đã chọn.

Mô hình áp dụng

Mô hình	Mặc định và công tắc suy nghĩ
claude-haiku-5-5	Mặc định bật, mức `medium`; chỉ ở `low/medium/high` mới tắt bằng `disabled`
claude-sonnet-5-5	Mặc định bật, mức `high`; không nhận `disabled`; ở `low/medium/high` dùng `between_tools` tắt suy nghĩ trước trả lời
claude-opus-5-5	Mặc định bật, mức `medium`; không tắt được
claude-fable-5-1	Mặc định bật, mức `high`; không tắt được
claude-opus-5	Mặc định bật, mức `high`; chỉ ở `low/medium/high` mới tắt bằng `disabled`
claude-sonnet-5	Mặc định bật, mức `high`; tắt bằng `disabled`
claude-fable-5	Mặc định bật, mức `high`; không tắt được
claude-opus-4-8	Mặc định tắt, mức `high`; bật bằng `adaptive`

Khác biệt Messages

Trường	Khác biệt
`thinking.type`	Cả tám hỗ trợ `adaptive`, không nhận `enabled` cũ và `budget_tokens`; khả năng tắt xem bảng, không áp `disabled` cho mọi mô hình
`between_tools`	Chỉ Sonnet 5.5; tắt suy nghĩ trước trả lời, tiến độ giữa công cụ vẫn trong `thinking`. Đối tượng chỉ chứa `type`, không `display`, `budget_tokens`
`output_config.effort`	Cả tám hỗ trợ `low/medium/high/xhigh/max`, mặc định xem bảng; `adaptive` là loại suy nghĩ không phải mức. `max_tokens` giới hạn cả suy nghĩ/trả lời
`thinking.display`	Khi bật, cả tám mặc định `omitted`: suy nghĩ rỗng và `signature`. Muốn tóm tắt đọc được đặt `summarized`; văn bản rỗng không có nghĩa không suy nghĩ
`tool_choice`	Opus 5.5, Sonnet 5.5, Fable 5.1 từ chối `any` và `tool` chỉ định; dùng `auto/none`. Năm mô hình khác cho ép nhưng bỏ suy nghĩ lần đó; Fable 5 không áp giới hạn Fable 5.1
Lịch sử suy nghĩ và chữ ký	Sau gọi công cụ, gửi đầy đủ `thinking/redacted_thinking` và khối công cụ trước, cả văn bản rỗng. Không sửa, đảo hay tạo lại chữ ký. Haiku 5.5, Sonnet 5.5, Opus 5.5, Fable 5.1 còn kiểm tra system, công cụ và lịch sử gốc; không tái dùng trực tiếp suy nghĩ cũ sau sửa lịch sử
Điền sẵn assistant	Cả tám không cho kết thúc bằng assistant chưa hoàn tất, trả `400`; dùng chỉ dẫn hoặc `output_config.format` để ràng buộc đầu ra
`temperature/top_p/top_k`	Bỏ trong ví dụ. `2023-06-01` vẫn chịu giới hạn lấy mẫu mô hình mới; với `2026-10-21`, bất kỳ mô hình truyền một trường cũng trả `400`. Đổi phiên bản không phục hồi lấy mẫu tùy chỉnh
Phiên bản công cụ Computer	Claude API: Haiku 5.5, Sonnet 5.5, Opus 5.5 dùng `computer_toolset_20260801`, không dùng loại Computer cũ. Nền tảng đám mây khác xem chính thức

Khác biệt Chat tương thích chính thức

Quy tắc lớp OpenAI SDK Anthropic, khác khả năng Messages gốc; không có nghĩa mọi kênh nền tảng dùng cùng chuyển đổi.

Trường	Khác biệt
`n`	Chỉ nhận `1`
`reasoning_effort`	Bỏ qua; chỉnh độ sâu/đọc suy nghĩ qua `output_config.effort` Messages
`response_format`, `tools[].function.strict`	Bỏ qua; không bật đầu ra cấu trúc gốc hay kiểm tra công cụ nghiêm ngặt
`presence_penalty/frequency_penalty/logit_bias/seed`	Bỏ qua, không điều khiển lấy mẫu tương ứng
`logprobs/top_logprobs`	Bỏ qua, không trả xác suất token
`system/developer`	Gộp vào system đầu, ngăn bằng xuống dòng; không giữ vị trí giữa hội thoại
`tool_choice`	`required` và hàm chỉ định theo giới hạn ép gọi ba mô hình trên
Đệm và cấu hình khác	Không cung cấp cấu hình đệm gốc; `store/service_tier/metadata/prediction/user/audio/modalities` và các trường tương tự bị bỏ, không bật khả năng cùng tên

Khác biệt bộ nhớ đệm

Trường	Khác biệt
`cache_control`	Dùng `type: ephemeral` Messages; tự chọn cấp cao hoặc dấu trên khối, tối đa bốn điểm ngắt
`ttl`	Mặc định `5m`, tùy chọn `1h`; không phải `prompt_cache_options` Chat
Tiền tố đệm tối thiểu	Haiku 5.5, Sonnet 5.5, Opus 5.5, Fable 5.1, Opus 5, Fable 5: `512` token đầu vào; Sonnet 5, Opus 4.8: `1024`. Phải giống tiền tố; dưới ngưỡng không ghi
Khối suy nghĩ	Không đặt dấu trực tiếp trên `thinking`; suy nghĩ lịch sử có thể đệm trong assistant trước đó
Mức sử dụng đệm	Xem `usage.cache_creation_input_tokens`, `usage.cache_read_input_tokens` để xác nhận ghi/đọc; đặt cấu hình không chứng minh trúng

Khác biệt đầu vào đa phương tiện

Đầu vào	Khối giao thức	Khác biệt
Hình ảnh	Messages `image`	URL hoặc Base64 trong `source`, không khối `image_url` Chat
Tài liệu	Messages `document`	Dùng cấu trúc tài liệu gốc trong user, không assistant
Hình ảnh	Chat `image_url`	Lớp chính thức đọc `image_url.url`, bỏ qua `detail`
Tệp	Chat `file`	Lớp chính thức bỏ đầu vào này; không bằng khả năng tài liệu gốc
Âm thanh	Chat `input_audio`	Lớp chính thức bỏ đầu vào này; không có khả năng âm thanh gốc

Ví dụ gọi

Thay MODEL_ID bằng ID đầy đủ. Messages bật suy nghĩ thích ứng và tóm tắt rõ ràng; Chat chỉ ví dụ văn bản cơ bản.

curl 'https://api.agtcloud.ai/v1/messages' \
  -H 'x-api-key: your-api-key' \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Giải thích cách xử lý thời gian chờ API bằng ba ý"}],
    "max_tokens": 4096,
    "thinking": {"type": "adaptive", "display": "summarized"},
    "output_config": {"effort": "medium"}
  }'