Source: https://aiprimetech.io/zh/docs/api-reference/messages/

[首页](/zh/) / [文档](/zh/docs/) / 消息 API 

# 消息 API 

POST /v1/messages——Anthropic 格式端点：参数、响应结构和示例。 

 复制页面 [ 以 Markdown 查看](/zh/docs/api-reference/messages.md) [ 向 ChatGPT 提问](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ 在 Claude 中提问](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

所有兼容 Anthropic 的客户端都使用此端点，包括 Claude Code 和官方 SDK。 

端点POST https://aiprimetech.io/v1/messages

身份验证x-api-key: sk-...

版本请求头anthropic-version: 2023-06-01

内容类型application/json 

## 请求体 

 | 字段 | 类型 | 必填 | 说明

 | model | 字符串 | 是 | 模型 ID，必须与以下列表中的值完全一致 /v1/models

 | messages | 数组 | 是 | 用户与助手轮流发言，最早的在前

 | max_tokens | 整数 | 是 | 最大输出 token 数。达到此上限时停止生成。

 | system | 字符串或数组 | 否 | 顶层系统提示词。不是消息角色。

 | temperature | 数值 | 否 | 0–1。省略则使用模型默认值。

 | top_p | 数值 | 否 | 核采样。使用此参数或 temperature，不要同时使用两者。

 | stop_sequences | 数组 | 否 | 生成这些字符串时停止生成

 | stream | 布尔值 | 否 | 设为 true 以启用服务器发送事件

 | tools | 数组 | 否 | 工具定义——参见 [工具使用](/zh/docs/api-reference/tool-use/)

 | metadata | 对象 | 否 | 原样传递； user_id 可用于您自己的归因 

## 示例 

```
Copycurl https://aiprimetech.io/v1/messages \
  -H "x-api-key: $CLAUDEAPIKEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'
```

## 响应 

```
Copy{
  "id": "msg_01ABC...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [{"type": "text", "text": "..."}],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {"input_tokens": 9, "output_tokens": 12}
}
```

 | 字段 | 说明

 | content | 内容块数组。文本块包含 type: text 以及一个 text 字段；工具调用包含 type: tool_use.

 | stop_reason | end_turn, max_tokens, stop_sequence 或 tool_use

 | usage.input_tokens | 计费输入，包括完整的重新发送的历史记录

 | usage.output_tokens | 计费输出——通常为输入费率的 4–5 倍 

## 系统提示词 

```
Copy{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "You are a terse assistant. Answer in at most two sentences.",
  "messages": [{"role": "user", "content": "Explain HTTP caching."}]
}
```

稳定的 system 块是以下功能的理想目标 [提示词缓存](/zh/docs/guides/prompt-caching/) ——它在每次调用中都完全相同，因此可以从缓存读取，费用仅为输入价格的一小部分。 

## 多模态输入 

图像块采用标准 Anthropic 结构——参见 [视觉](/zh/docs/api-reference/vision/). 

[流式传输逐 token 输出](/zh/docs/api-reference/streaming/)[工具使用函数调用](/zh/docs/api-reference/tool-use/)[错误故障模式](/zh/docs/api-reference/errors/) 

[上一页API 概述](/zh/docs/api-reference/overview/)[下一页聊天补全 API](/zh/docs/api-reference/chat-completions/)