> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexusapi.link/llms.txt
> Use this file to discover all available pages before exploring further.

# API Anthropic Messages

> Gọi mô hình có nhãn anthropic bằng giao thức Anthropic Messages gốc.

Dùng API này cho mô hình có nhãn `anthropic` trong Chợ mô hình hoặc danh sách mô hình của key hiện tại. Hãy xem [ma trận khả năng](/vi/developer/capability-matrix) trước: **mô hình, nhóm key và giao thức phải cùng khớp**.

<Warning>
  **Messages không phải endpoint chung cho mọi mô hình**

  Ứng dụng tương thích OpenAI nên dùng [Chat Completions](/vi/developer/openai-compatible). Không chuyển kênh Claude kiểu Anthropic hiện tại sang `/v1/responses`; `not implemented` thường là không tương thích giao thức, không phải lỗi tạm thời có thể giải quyết bằng retry.
</Warning>

## Endpoint và yêu cầu tối thiểu

```text theme={"system"}
POST https://nexusapi.link/v1/messages
```

```bash theme={"system"}
curl 'https://nexusapi.link/v1/messages' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'anthropic-version: 2023-06-01' \
  -d '{
    "model": "YOUR_ANTHROPIC_MODEL_ID",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Xin chào"}]
  }'
```

| Mục                 | Bắt buộc              | Ghi chú                                                             |
| ------------------- | --------------------- | ------------------------------------------------------------------- |
| `model`             | Có                    | Model ID chính xác mà key hiện tại nhìn thấy và có nhãn `anthropic` |
| `max_tokens`        | Có                    | Số token đầu ra tối đa cho yêu cầu này                              |
| `messages`          | Có                    | Hội thoại theo định dạng Anthropic Messages                         |
| `anthropic-version` | Giao thức gốc yêu cầu | SDK tự quản lý; khi gọi thủ công dùng phiên bản tương thích         |

Xem [tài liệu API Apifox](https://nexusapi.apifox.cn/) và tài liệu giao thức của client Anthropic đang dùng để biết toàn bộ trường, tools, streaming và schema phản hồi. Khả năng của trường tùy chọn vẫn phụ thuộc model và kênh.

## Dùng Anthropic SDK

SDK gốc tự quản lý các header giao thức cần thiết. Truyền NexusAPI key vào SDK và đặt Base URL **không có `/v1`**:

```python theme={"system"}
from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://nexusapi.link",
)

message = client.messages.create(
    model="YOUR_ANTHROPIC_MODEL_ID",
    max_tokens=256,
    messages=[{"role": "user", "content": "Xin chào"}],
)
```

SDK tự thêm `/v1/messages`. Không đặt `base_url` là `https://nexusapi.link/v1/messages`, vì có thể lặp đường dẫn hoặc gây 404.

## Claude Code và ứng dụng tự viết

| Tình huống                   | Cấu hình                                                                                                                                                      |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Claude Code                  | Theo [hướng dẫn Claude Code](/vi/tools/claude-code): đặt `ANTHROPIC_BASE_URL=https://nexusapi.link` và `ANTHROPIC_AUTH_TOKEN` trong `~/.claude/settings.json` |
| Anthropic SDK / ứng dụng gốc | Base URL là `https://nexusapi.link`, để client gửi Messages                                                                                                   |
| Ứng dụng dùng OpenAI SDK     | Không trộn cấu hình này; dùng [Chat Completions](/vi/developer/openai-compatible)                                                                             |

## Khắc phục sự cố

* `401`: kiểm tra key đúng, đang hoạt động và chưa bị reset sau khi lộ.
* `404`: kiểm tra SDK có tự thêm `/v1` lần thứ hai hay không.
* `400`: kiểm tra chỉ với `model`, `max_tokens`, `messages` trước rồi thêm dần trường tùy chọn.
* `500, not implemented`: đảm bảo mô hình Anthropic không đi qua `/v1/responses`.

Nếu lỗi kéo dài, lưu Request ID và yêu cầu đã che thông tin, sau đó làm theo [tự kiểm tra](/vi/faq/self-check).