Claude Messages API 接入指南
Claude Messages API：四个模型，一套接入方式
选择 Claude 模型，在一张表中比较全部 Token 价格，然后复制完整的 Anthropic Messages 请求。整个系列共用相同的接口、鉴权方式、流式格式和缓存用量字段。
Save69%
四个 Claude 模型价格汇总
官方价与 AIReiter 促销价按每 1M Tokens 对比。Opus、Sonnet 和 Fable 的输入输出价格最高可节省约 69%。
| 模型 | 适合场景 | 输入 | 输出 | 缓存读取 | 缓存创建 |
|---|---|---|---|---|---|
| Claude Opus 4.8 | 深度推理 | 官方 $5.00AIReiter $1.56 | 官方 $25.00AIReiter $7.76 | - | - |
| Claude Opus 4.7 | 成熟旗舰 | 官方 $5.00AIReiter $1.56 | 官方 $25.00AIReiter $7.76 | - | - |
| Claude Sonnet 5性价比推荐 | 生产默认 | 官方 $2.00AIReiter $0.63 | 官方 $10.00AIReiter $3.11 | 官方 $0.20AIReiter $0.07 | 官方 $2.50AIReiter $0.78 |
| Claude Fable 5 | 创意专用 | 官方 $10.00AIReiter $3.42 | 官方 $50.00AIReiter $17.06 | 官方 $1.00AIReiter $3.42 | 官方 $12.50AIReiter $4.27 |
如何配置
从三种接入方式中选择一种。三种方式使用相同的 Messages 接口和模型 ID。
Messages API
/api/v1/messagesAnthropic SDK
适合后端服务、助手和 Agent。配置一次 baseURL，然后调用 client.messages.create。
客户端 Base URL
https://aireiter.com/api最终请求 URL
https://aireiter.com/api/v1/messages模型
claude-sonnet-5鉴权请求头
x-api-key复制完整配置
所选模型已经写入示例，发送请求前替换示例 API Key 即可。
可直接复制
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: process.env.AIREITER_API_KEY,
baseURL: "https://aireiter.com/api",
});
const message = await client.messages.create({
model: "claude-sonnet-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Review this API design." }],
});
console.log(message.content);Messages API
/api/v1/messagesCC Switch（图形界面）
通过图形界面管理 Anthropic 供应商，无需修改配置文件即可切换 Claude 模型。
客户端 Base URL
https://aireiter.com/api最终请求 URL
https://aireiter.com/api/v1/messages模型
claude-sonnet-5鉴权请求头
x-api-key复制完整配置
所选模型已经写入示例，发送请求前替换示例 API Key 即可。
可直接复制
供应商名称: AIReiter
API 格式: Anthropic
Base URL: https://aireiter.com/api
API Key: sk-your-key
模型: claude-sonnet-5Messages API
/api/v1/messages终端 curl
在排查 SDK 或桌面客户端之前，直接验证接口、API Key 和模型 ID。
客户端 Base URL
https://aireiter.com/api最终请求 URL
https://aireiter.com/api/v1/messages模型
claude-sonnet-5鉴权请求头
x-api-key复制完整配置
所选模型已经写入示例，发送请求前替换示例 API Key 即可。
可直接复制
curl "https://aireiter.com/api/v1/messages" \
-H "x-api-key: $AIREITER_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"stream": false,
"messages": [
{ "role": "user", "content": "Explain this change step by step." }
]
}'Messages API 参考
核心请求参数
这 8 个字段已经覆盖常见文本、流式、工具调用和提示词缓存场景，不把本页扩展成冗长的完整协议文档。
| 参数 | 要求 | 用途 |
|---|---|---|
model | 必填 | 用于路由请求的 Claude 模型 ID。 |
messages | 必填 | 发送给模型的对话消息。 |
max_tokens | 必填 | 最大输出 Token 数量。 |
system | 可选 | 顶层指令和稳定上下文。 |
stream | 可选 | 设为 true 时返回增量 SSE 事件。 |
temperature | 可选 | 控制响应随机性。 |
tools | 可选 | 提供给模型使用的工具定义。 |
cache_control | 可选 | 标记可复用内容以启用提示词缓存。 |
流式响应
生成过程中持续接收文本
将 stream 设为 true，并持续读取 Server-Sent Events 直到 message_stop；文本通过 content_block_delta 事件增量返回。
curl
curl "https://aireiter.com/api/v1/messages" \
-H "x-api-key: $AIREITER_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"stream": true,
"messages": [{ "role": "user", "content": "Explain this API." }]
}'提示词缓存
缓存稳定的提示词前缀
在稳定的 system 内容中加入 cache_control。首次符合条件的请求可能创建缓存，后续匹配前缀可报告缓存读取。
request.json
{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"system": [{
"type": "text",
"text": "<stable project context>",
"cache_control": { "type": "ephemeral" }
}],
"messages": [{ "role": "user", "content": "Review this change." }]
}cache_creation_input_tokens · cache_read_input_tokens
Claude Code 配置
一个 Base URL 接入 Claude Code
Claude Code 原生使用 Messages 协议。只需配置一次 AIReiter Base URL 和 Token，之后切换任意 Claude 模型都无需改变传输协议。
- 客户端 Base URL
- https://aireiter.com/api
- 鉴权环境变量
- ANTHROPIC_AUTH_TOKEN
terminal
export ANTHROPIC_BASE_URL="https://aireiter.com/api"
export ANTHROPIC_AUTH_TOKEN="$AIREITER_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
cd ~/your-project
claude --model claude-sonnet-5客户端兼容
整套 Claude 工作流共用同一个接口
协议始终保持 Anthropic 原生格式。Claude Code、CC Switch、SDK 与直接 HTTP 请求之间，变化的只有配置入口。
Claude Code
配置一次环境变量，即可在任意项目目录启动 Claude Code。
ANTHROPIC_BASE_URLCC Switch
创建 Anthropic 供应商，只填写 Base URL，不要追加 /v1/messages。
https://aireiter.com/api直接调用 API
使用 x-api-key 和 anthropic-version 请求头发送 Messages 请求。
/v1/messagesClaude API 常见问题
SDK 应该填写哪个 URL？
SDK Base URL 填写 https://aireiter.com/api，Anthropic SDK 会自动追加 /v1/messages；只有直接 HTTP 请求才使用完整 URL。
如何确认缓存命中？
检查响应中的 usage.cache_read_input_tokens。仅仅重复发送请求，不能证明稳定前缀已经被缓存复用。
如何切换 Claude 模型？
接口和请求头保持不变，只需要把 model 字段替换为 claude-opus-4-8、claude-opus-4-7、claude-sonnet-5 或 claude-fable-5。