Trang chủ / Tài liệu / API Messages

API Messages

POST /v1/messages — endpoint theo định dạng Anthropic: tham số, cấu trúc phản hồi và ví dụ.

Xem dưới dạng Markdown Hỏi ChatGPT Hỏi trong Claude

Endpoint mà mọi ứng dụng khách tương thích với Anthropic đều sử dụng, bao gồm Claude Code và các SDK chính thức.

EndpointPOST https://aiprimetech.io/v1/messages

Xác thựcx-api-key: sk-...

Header phiên bảnanthropic-version: 2023-06-01

Loại nội dungapplication/json

Nội dung yêu cầu

Trường	Loại	Bắt buộc	Mô tả
`model`	chuỗi	có	Mã định danh mô hình, đúng như được liệt kê bởi `/v1/models`
`messages`	mảng	có	Các lượt người dùng / trợ lý xen kẽ, lượt cũ nhất trước
`max_tokens`	số nguyên	có	Số token đầu ra tối đa. Quá trình tạo dừng tại giới hạn này.
`system`	chuỗi hoặc mảng	không	Lời nhắc hệ thống ở cấp cao nhất. Không phải vai trò của một tin nhắn.
`temperature`	số	không	0–1. Bỏ qua để dùng giá trị mặc định của mô hình.
`top_p`	số	không	Lấy mẫu nucleus. Dùng tham số này hoặc temperature, không dùng cả hai.
`stop_sequences`	mảng	không	Các chuỗi khiến quá trình tạo dừng khi được sinh ra
`stream`	giá trị boolean	không	true để nhận sự kiện do máy chủ gửi
`tools`	mảng	không	Định nghĩa công cụ — xem Sử dụng công cụ
`metadata`	đối tượng	không	Được chuyển tiếp nguyên trạng; `user_id` hữu ích để bạn tự theo dõi nguồn sử dụng

Ví dụ

curl https://aiprimetech.io/v1/messages \
  -H "x-api-key: $CLAUDEAPIKEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Phản hồi

{
  "id": "msg_01ABC...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [{"type": "text", "text": "..."}],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {"input_tokens": 9, "output_tokens": 12}
}

Trường	Mô tả
`content`	Mảng các khối. Khối văn bản chứa `type: text` và một `text` trường; các lệnh gọi công cụ chứa `type: tool_use`.
`stop_reason`	`end_turn`, `max_tokens`, `stop_sequence` hoặc `tool_use`
`usage.input_tokens`	Đầu vào được tính phí, bao gồm toàn bộ lịch sử được gửi lại
`usage.output_tokens`	Đầu ra được tính phí — thường bằng 4–5 lần đơn giá đầu vào

Lời nhắc hệ thống

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "You are a terse assistant. Answer in at most two sentences.",
  "messages": [{"role": "user", "content": "Explain HTTP caching."}]
}

Một khối ổn định system là đối tượng lý tưởng cho bộ nhớ đệm lời nhắc — khối này giống hệt nhau trong mọi lần gọi, nên có thể được đọc từ bộ nhớ đệm với chi phí chỉ bằng một phần nhỏ giá đầu vào.

Đầu vào đa phương thức

Các khối hình ảnh sử dụng cấu trúc chuẩn của Anthropic — xem Thị giác.

Truyền dữ liệu theo luồngĐầu ra theo từng token Sử dụng công cụGọi hàm LỗiCác dạng lỗi