消息 API
POST /v1/messages——Anthropic 格式端点：参数、响应结构和示例。
所有兼容 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 | 数组 | 否 | 工具定义——参见 工具使用 |
metadata | 对象 | 否 | 原样传递； user_id 可用于您自己的归因 |
示例
curl 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"}]
}'响应
{
"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 倍 |
系统提示词
{
"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 块是以下功能的理想目标 提示词缓存 ——它在每次调用中都完全相同，因此可以从缓存读取，费用仅为输入价格的一小部分。多模态输入
图像块采用标准 Anthropic 结构——参见 视觉.