# Messages(官方Anthropic格式)

**方法**: `POST`
**路径**: `/v1/messages`

该接口用于按 Anthropic Messages 格式调用可用的 Claude / LLM 模型。请求地址为 `{BaseURL}/v1/messages`，Base URL 与 API Key 的获取方式见 [获取 Base URL 和 API Key](/api/doc-6535931)。

## 最小文本请求

## 请求参数

### Header 参数

```text
Authorization
string
必填
默认值:
Bearer YOUR_API_KEY
```

```text
Content-Type
string
必填
默认值:
application/json
```

```text
anthropic-version
string
可选
示例:
2023-06-01
```

### Body 参数 application/json

```text
object
示例
{
  "model": "claude-3-5-sonnet-20240620",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Hello, Claude format."
        }
      ]
    }
  ]
}
```

常用字段：

| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `model` | string | 是 | 模型名称。可通过 [列出模型](/api/api-287780941) 查看账号可用模型。 |
| `max_tokens` | number | 是 | 最大输出 token 数。 |
| `messages` | array | 是 | Anthropic Messages 格式的消息数组。 |
| `messages[].role` | string | 是 | 通常为 `user` 或 `assistant`。 |
| `messages[].content` | array | 是 | 内容块数组，文本块使用 `{ "type": "text", "text": "..." }`。 |
| `stream` | boolean | 否 | 是否使用流式响应，按上游模型能力决定。 |

## 请求示例代码

### Shell

```bash
curl --location --request POST '{BaseURL}/v1/messages' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "claude-3-5-sonnet-20240620",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Hello, Claude format."
        }
      ]
    }
  ]
}'
```

## 图片请求

图片理解也走同一个 `/v1/messages` 端点，`content` 中加入 `image` 内容块即可。示例见 [Messages(识图)](/api/api-266125082)。

## 迁移提示

- 如果你原来调用 Anthropic 官方 API，通常只需要替换 Base URL 与 API Key，并确认 `model` 名称在当前账号可用。
- 如果你原来调用 OpenAI Chat Completions，端点需要从 `/v1/chat/completions` 改为 `/v1/messages`，并把消息内容改成 Anthropic 内容块格式。
- 不要在前端公开代码、日志、截图或 GitHub 中暴露 API Key。

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
object
```

#### 示例

```json
{
  "id": "msg_xxx",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello. How can I help?"
    }
  ],
  "model": "claude-3-5-sonnet-20240620",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 8
  }
}
```