---
description: "与 Anthropic 兼容的 Messages 接口，Claude 模型的原生调用方式。"
---

# Anthropic Messages

> 端点: `POST https://oneapi.zaiwenai.com/v1/messages`

与 Anthropic Messages API 接口兼容，支持 Claude 模型的原生调用方式。

## 认证方式

支持两种认证方式：

- `Authorization: Bearer $YOUR_API_KEY`
- `x-api-key: $YOUR_API_KEY`

## 请求参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `model` | string | 是 | 模型名称（如 `claude-haiku-4.5`） |
| `messages` | array | 是 | 消息列表 |
| `max_tokens` | integer | 是 | 最大输出 Token 数 |
| `stream` | boolean | 否 | 是否启用流式响应，默认 `false` |
| `system` | string | 否 | 系统提示词 |
| `tools` | array | 否 | 工具定义列表 |

其他参数请参考 [Anthropic Messages API 文档](https://docs.anthropic.com/en/api/messages)。

## Curl 示例

```bash
curl https://oneapi.zaiwenai.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-haiku-4.5",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Hello!"
      }
    ]
  }'
```

## 流式响应

```bash
curl https://oneapi.zaiwenai.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-haiku-4.5",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
      {
        "role": "user",
        "content": "Tell me a short story"
      }
    ]
  }'
```

## 计费说明

与 Chat Completions 接口相同，按 Token 用量计费。
