---
title: "Create a Message (Default Base) - Anthropic Messages - OB Cloud 云数据库 master | OceanBase 文档中心"
description: Create a Message (Default Base) - Anthropic Messages 功能说明 通过标准 API 端点提供的 Anthropic Messages 兼容接口，支持流式与非流式响应。与专用 Anthropic 端点不同，此接口使用统一的基础路径 /api/v1/messages ，适…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*qbZXRo_94ZEAAAAAAAAAAAAADiGDAQ/original) OB Cloud 云数据库

# Create a Message (Default Base) - Anthropic Messages

更新时间：2026-07-02 17:33:29

## 功能说明

通过标准 API 端点提供的 Anthropic Messages 兼容接口，支持流式与非流式响应。与专用 Anthropic 端点不同，此接口使用统一的基础路径 `/api/v1/messages`，适用于需要与 Anthropic Messages API 兼容但希望使用标准端点的场景。

#### 说明

使用 prompt cache 时，请将 `cache_control` 显式设置在具体的 content block（如 text chunk）上以稳定生效；仅设置在 message 顶层的自动 cache 提示可能不会被可靠透传，导致 cache 不命中。

#### 说明

本接口与 [100.create-anthropic-message.md](https://www.oceanbase.com/docs/common-oceanbase-cloud-1000000005766996) 的区别在于端点路径不同。该文件使用专用端点 `/api/anthropic/v1/messages`，而本文档使用标准端点 `/api/v1/messages`。

## 调用说明

### 接口约束

- 调用者需要拥有 API Key，详情请参见 [管理 AI API Key](https://www.oceanbase.com/docs/common-oceanbase-cloud-1000000005766992)。

### 请求路径

`POST {BASE_URL}/api/v1/messages`

### 请求头

| 名称 | 是否必选 | 示例值 | 描述 |
| --- | --- | --- | --- |
| Authorization | 是 | Bearer {token} | 鉴权信息 |
| Content-Type | 否 | application/json | 请求体格式 |

## 请求参数

### Path 参数

无

### Query 参数

无

### Body 参数

| 名称 | 类型 | 是否必填 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| model | string | 是 | claude-3-opus-20240229 | 模型名称 |
| max_tokens | integer | 是 | 1024 | Anthropic 官方要求必填，建议始终显式传入。 |
| messages | array[object] | 是 | [{"role": "user", "content": "Hello"}] | 消息列表 |
| stream | boolean | 否 | false | 是否启用流式响应 |

## 返回结果

### 返回参数

| 名称 | 类型 | 描述 |
| --- | --- | --- |
| success | boolean | 请求是否成功 |
| code | string | 返回码 |
| message | string | 返回信息 |
| data | object | 业务返回数据 |

### data 字段说明

返回数据结构根据请求的 `stream` 参数不同而不同：

- 当 `stream: false` 时，`data` 字段为完整的响应对象。
 - 当 `stream: true` 时，响应为 `text/event-stream` 格式，`data` 字段不适用。

## 请求示例

```bash
curl --request POST '{BASE_URL}/api/v1/messages' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "claude-3-opus-20240229",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Hello"
      }
    ],
    "stream": false
  }'

```

## 返回示例

**非流式响应示例 (application/json):**

```json
{
  "success": true,
  "code": "200",
  "message": "successful",
  "data": {
    "id": "msg_123456",
    "model": "claude-3-opus-20240229",
    "choices": [
      {
        "index": 0,
        "message": {
          "role": "assistant",
          "content": "Hello! How can I assist you today?"
        }
      }
    ]
  }
}

```

**流式响应示例 (text/event-stream):**

```
data: {"id":"msg_123","object":"chat.completion.chunk","choices":[{"delta":{"content":"Hello"}}]}

data: {"id":"msg_123","object":"chat.completion.chunk","choices":[{"delta":{"content":"!"}}]}

data: [DONE]

```

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线