Source: https://aiprimetech.io/vi/docs/api-reference/messages/

[Trang chủ](/vi/) / [Tài liệu](/vi/docs/) / 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ụ. 

 Sao chép trang [ Xem dưới dạng Markdown](/vi/docs/api-reference/messages.md) [ Hỏi ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Hỏi trong Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

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ụ](/vi/docs/api-reference/tool-use/)

 | 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ụ 

```
Copycurl 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 

```
Copy{
  "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 

```
Copy{
  "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](/vi/docs/guides/prompt-caching/) — 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](/vi/docs/api-reference/vision/). 

[Truyền dữ liệu theo luồngĐầu ra theo từng token](/vi/docs/api-reference/streaming/)[Sử dụng công cụGọi hàm](/vi/docs/api-reference/tool-use/)[LỗiCác dạng lỗi](/vi/docs/api-reference/errors/) 

[TrướcTổng quan về API](/vi/docs/api-reference/overview/)[Tiếp theoAPI Chat Completions](/vi/docs/api-reference/chat-completions/)