Source: https://ailoot.ai/docs/vi/api/messages/
Canonical: https://ailoot.ai/docs/vi/api/messages/
Language: vi

[API](https://ailoot.ai/docs/vi/) 

# Messages

[Markdown](https://ailoot.ai/docs/vi/api/messages/index.md)

Định dạng Anthropic Messages, được Claude Code, Anthropic SDK và nhiều tác nhân sử dụng.

POST`https://api.ailoot.ai/v1/messages`

Messages

```bash
curl https://api.ailoot.ai/v1/messages \
  -H "x-api-key: $AILOOT_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": "Xin chào! Bạn làm được những gì?"}]
  }' 
```

```python
import anthropic
import os

client = anthropic.Anthropic(max_retries=0, 
    base_url="https://api.ailoot.ai",   # không có /v1: SDK tự thêm /v1/messages
    api_key=os.environ["AILOOT_API_KEY"],
)

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Giải thích API là gì trong hai câu."}],
)
print(msg.content[0].text)
```

```js
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ maxRetries: 0,
  baseURL: "https://api.ailoot.ai", // không có /v1
  apiKey: process.env.AILOOT_API_KEY,
});

const msg = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Giải thích API là gì trong hai câu." }],
});
console.log(msg.content[0].type === "text" ? msg.content[0].text : msg.content);
```

200 OK

```json
{
  "id": "msg_01H…",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [
    { "type": "text", "text": "Xin chào! Tôi có thể viết và giải thích mã, trả lời câu hỏi…" }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 14, "output_tokens": 52 }
}
```

## Xác thực

| Tham số | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `x-api-key` | header | bắt buộc | Khóa `sk-…`. Cũng có thể dùng `Authorization: Bearer sk-…` — Claude Code dùng cách này với `ANTHROPIC_AUTH_TOKEN`. |
| `anthropic-version` | header | không bắt buộc | Phiên bản API, ví dụ `2023-06-01`. SDK tự gửi giá trị này. |

## Phần thân yêu cầu

| Tham số | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `model` | string | bắt buộc | ID mô hình hỗ trợ định dạng Messages — 776 mã định danh: Claude cùng GPT, Gemini, DeepSeek, Qwen và các mô hình khác. |
| `messages` | array | bắt buộc | Tin nhắn `user` và `assistant`; `content` — chuỗi hoặc các khối (`text`, `image`, `tool_use`, `tool_result`). |
| `max_tokens` | integer | bắt buộc | Số token tối đa của phản hồi. Giới hạn này được tính vào khoản tiền giữ trước; nếu số dư không đủ cho toàn bộ giới hạn, Ailoot giảm giới hạn nhưng không thấp hơn 256 (1025 khi bật suy nghĩ) và thông báo giới hạn mới trong header `X-Ailoot-Max-Tokens-Capped`. |
| `system` | string \| array | không bắt buộc | Chỉ dẫn hệ thống. |
| `stream` | boolean | không bắt buộc | Luồng sự kiện SSE (`message_start`, `content_block_delta`, …, `message_stop`). Văn bản tính phí được gửi thành một khối sau khi tính chi phí. |
| `temperature` | number | không bắt buộc | Mức độ ngẫu nhiên của phản hồi từ 0 đến 1. |
| `tools` | array | không bắt buộc | Công cụ: `name`, `description`, `input_schema`. |
| `tool_choice` | object | không bắt buộc | `auto`, `any`, `tool` hoặc `none`. |
| `thinking` | object | không bắt buộc | `{"type": "enabled", "budget_tokens": N}` — suy nghĩ đối với các mô hình hỗ trợ. |
| `stop_sequences` | array | không bắt buộc | Các chuỗi khiến quá trình tạo nội dung dừng lại. |

## Phản hồi

| Tham số | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `content` | array |  | Các khối phản hồi: `text`, `thinking`, `tool_use`. |
| `stop_reason` | string |  | `end_turn`, `max_tokens`, `stop_sequence` hoặc `tool_use`. |
| `usage` | object |  | `input_tokens`, `output_tokens`, đối với bộ nhớ đệm — `cache_read_input_tokens` và `cache_creation_input_tokens`. |

Đếm token (`POST /v1/messages/count_tokens`) hiện không khả dụng đối với các mô hình trong danh mục.

Còn câu hỏi? Hãy gửi Request ID và mô tả — chúng tôi sẽ giúp tìm hiểu.[Liên hệ hỗ trợ](mailto:support@ailoot.ai)

## Ailoot · Công ty và danh mục dự án của công ty





Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục.





Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.





Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.