RelayRouter协议
兼容 Anthropic 的 API
Claude 客户端使用 Anthropic Messages API，RelayRouter 同样支持。把 Anthropic SDK 指向 https://relayrouter.io，请求格式、anthropic-version 头和流式事件完全不变，只需换成 RelayRouter 密钥。Claude Code 通过两个环境变量即可接入。
Base URL 与端点
https://relayrouter.io 不要加 /v1 后缀：Anthropic SDK 和 Claude Code 会自己拼接 /v1/messages。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/messages | Messages API，stream: true 流式，工具调用与 extended thinking 原样透传 |
| GET | /v1/models | 你的密钥可调用的模型列表 |
鉴权： x-api-key: <你的 RelayRouter 密钥>，或 Authorization: Bearer <密钥>。两种请求头都接受；anthropic-version 保持 SDK 默认值。
代码
Python
import anthropic
client = anthropic.Anthropic(
api_key="your-relayrouter-key",
base_url="https://relayrouter.io",
)
msg = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(msg.content[0].text)TypeScript
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: process.env.RELAYROUTER_API_KEY,
baseURL: "https://relayrouter.io",
});
const msg = await client.messages.create({
model: "claude-sonnet-4-6",
max_tokens: 1024,
messages: [{ role: "user", content: "Hello!" }],
});
console.log(msg.content[0].type === "text" ? msg.content[0].text : "");Claude Code
export ANTHROPIC_BASE_URL="https://relayrouter.io"
export ANTHROPIC_AUTH_TOKEN="your-relayrouter-key"
export ANTHROPIC_MODEL="claude-opus-5-5"
claude使用这一协议的分组
一把密钥属于一个分组。在控制台为下面任一分组创建密钥；模型页有全部分组与模型的实时费率。
可直接使用的工具
- Anthropic SDK (Python, TypeScript, Java, Go): 设置 base_url 与 api_key
- Claude Code: ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN (指南)
- Cline / Roo Code: Anthropic 提供方加自定义 base URL (指南)
- LangChain ChatAnthropic: anthropic_api_url=https://relayrouter.io
常见问题
extended thinking 和工具调用能用吗？
可以。请求原样转发，包括 thinking 参数、tools 与 tool_choice，流式事件也原样返回。
有哪些 Claude 模型和分组？
多个费率不同的 Claude 分组提供 claude-opus-5-5、claude-fable-5-1、claude-sonnet-4-6、claude-haiku-4-5 以及更早的 Opus 和 Sonnet 版本。创建密钥时选的分组决定费率，模型页有完整列表。
能用 ANTHROPIC_API_KEY 代替 ANTHROPIC_AUTH_TOKEN 吗？
可以。ANTHROPIC_API_KEY 以 x-api-key 发送，ANTHROPIC_AUTH_TOKEN 以 Bearer 发送，RelayRouter 两者都接受。
怎么计费？
按分组费率从预付余额按 token 扣除，无平台费，失败请求不计费。缓存读取与缓存写入 token 和原生 API 一样在 usage 中返回。