Anthropic Messages

Gửi tin nhắn và Content Blocks bằng cấu trúc tương thích Anthropic Messages.

API Messages sử dụng tin nhắn user, assistant và Content Blocks để tạo phản hồi của mô hình, hỗ trợ văn bản, hình ảnh, gọi công cụ, đầu ra dạng luồng và suy nghĩ mở rộng. Các khối nội dung, công cụ và tham số nâng cao khả dụng có thể khác nhau giữa các mô hình; căn cứ vào mô hình khả dụng với API Key hiện tại và khả năng thực tế của API.

POST/v1/messages

Tạo phản hồi assistant tiếp theo từ các tin nhắn user và assistant. Nội dung tin nhắn có thể là chuỗi hoặc Content Blocks gồm văn bản, hình ảnh, công cụ và tài liệu.

API hỗ trợ phản hồi JSON thông thường và sự kiện SSE dạng luồng; khả năng hỗ trợ hình ảnh, gọi công cụ và suy nghĩ mở rộng phụ thuộc vào mô hình đã chọn.

Xác thực

anthropicApiKey

x-api-key<token>

Truyền API Key trong Header x-api-key.

Vị trí truyền: header

Tham số Header

anthropic-version*string

Chỉ định phiên bản API cần sử dụng.

Giá trị mặc định"2023-06-01"

anthropic-beta?string

Chỉ định phiên bản beta cần sử dụng. Có thể phân tách nhiều giá trị bằng dấu phẩy hoặc gửi Header này nhiều lần.

Nội dung yêu cầu

Messages biểu diễn văn bản, hình ảnh, công cụ và suy nghĩ mở rộng bằng Content Blocks. Chọn chế độ xem theo tác vụ.

application/json

Hội thoại văn bản

Dùng tin nhắn user và assistant để tổ chức hội thoại một hoặc nhiều lượt; system dùng trường cấp cao nhất.

model: ID mô hình hỗ trợ Messages và khả dụng với API Key hiện tại.
max_tokens: Số token tối đa được phép tạo trong phản hồi này.
messages[]: Các tin nhắn user và assistant theo thứ tự.

application/json

{
  "model": "MODEL_ID",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Xin chào! Hãy giới thiệu bản thân."
    }
  ]
}

Hội thoại văn bản cơ bản. messages có thể dùng chuỗi hoặc khối nội dung text.

model*string

ID mô hình cần dùng. Chọn mô hình hỗ trợ Messages và khả dụng với API Key hiện tại.

Độ dài1 <= length <= 256

max_tokens*integer

Số token tối đa được phép tạo. Mỗi mô hình có giới hạn riêng; đặt 0 để chỉ nạp bộ nhớ đệm prompt mà không tạo phản hồi.

Phạm vi0 <= value

messages*array<>

Tin nhắn hội thoại văn bản theo thứ tự gửi. content có thể là chuỗi hoặc mảng khối nội dung text.

Số phần tử1 <= items

metadata?

Siêu dữ liệu liên quan đến yêu cầu.

cache_control?|null

Điều khiển bộ nhớ đệm ở cấp cao nhất, tự động áp dụng cho khối nội dung cuối cùng có thể lưu đệm trong yêu cầu. Khả năng sử dụng phụ thuộc vào mô hình và kênh.

container?||null

Tái sử dụng container qua nhiều yêu cầu hoặc chỉ định Skills cần tải vào container. Khả năng sử dụng phụ thuộc vào mô hình, kênh và tài khoản.

inference_geo?string|null

Chỉ định khu vực địa lý thực hiện suy luận; khi không đặt, sử dụng khu vực mặc định của tài khoản. Khả năng sử dụng phụ thuộc vào tài khoản và kênh.

output_config?

Cấu hình đầu ra của mô hình. Khả năng sử dụng trường phụ thuộc vào mô hình và kênh đã chọn.

service_tier?string

Cấp dịch vụ dùng cho yêu cầu. auto có thể sử dụng dung lượng ưu tiên khi khả dụng; standard_only chỉ dùng dung lượng tiêu chuẩn. Phạm vi hỗ trợ thực tế phụ thuộc vào tài khoản và kênh.

Giá trị được phép

"auto"
"standard_only"

stop_sequences?array<string>

Chuỗi văn bản tùy chỉnh dùng để dừng tạo nội dung.

stream?boolean

Có trả về phản hồi tăng dần qua sự kiện do máy chủ gửi hay không.

Giá trị mặc địnhfalse

system?|array<>

Prompt hệ thống ở cấp cao nhất. Danh sách Messages không có vai trò system.

temperature?number

Đã ngừng khuyến nghị

Đã ngừng khuyến nghị. Các mô hình phát hành sau Claude Opus 4.6 không hỗ trợ temperature tùy chỉnh; có thể chấp nhận 1.0 để tương thích yêu cầu cũ, còn giá trị khác có thể trả về 400. Nên bỏ trường này với mô hình mới.

Phạm vi0 <= value <= 1

thinking?||

Cấu hình suy nghĩ mở rộng. Ưu tiên adaptive với mô hình mới; mô hình cũ có thể tiếp tục dùng enabled và budget_tokens.

tool_choice?||

tools?array<|||||||>

Công cụ tùy chỉnh hoặc công cụ tích hợp mà mô hình có thể sử dụng.

top_k?integer

Đã ngừng khuyến nghị

Đã ngừng khuyến nghị. Các mô hình phát hành sau Claude Opus 4.6 có thể từ chối mọi giá trị top_k và trả về 400. Nên bỏ trường này với mô hình mới.

Phạm vi1 <= value

top_p?number

Đã ngừng khuyến nghị

Đã ngừng khuyến nghị. Các mô hình phát hành sau Claude Opus 4.6 chỉ giữ khả năng tương thích hạn chế với giá trị gần mặc định; giá trị khác có thể trả về 400. Nên bỏ trường này với mô hình mới.

Phạm vi0 < value < 1

Khả năng hỗ trợ hình ảnh, công cụ và suy nghĩ mở rộng có thể khác nhau theo mô hình và kênh của nhà cung cấp. Nên hoàn thành yêu cầu văn bản tối thiểu trước, rồi bật từng trường nâng cao.

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/v1/messages" \  -H "anthropic-version: 2023-06-01" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "max_tokens": 1024,    "messages": [      {        "role": "user",        "content": "Xin chào! Hãy giới thiệu bản thân."      }    ]  }'

{
  "content": [
    {
      "type": "text",
      "text": "Xin chào! Tôi là một trợ lý AI."
    }
  ],
  "id": "msg_example",
  "model": "MODEL_ID",
  "role": "assistant",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "type": "message",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 16,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

Tài liệu chính thức Anthropic MessagesXem định nghĩa giao thức phía nhà cung cấp và các thay đổi trường mới nhất.

Xác thực

Tham số Header

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`