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 的区别在于端点路径不同。该文件使用专用端点 /api/anthropic/v1/messages，而本文档使用标准端点 /api/v1/messages。

调用说明

接口约束

调用者需要拥有 API Key，详情请参见管理 AI API Key。

请求路径

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 字段不适用。

请求示例

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):

{
  "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]