# 通过 RelayRouter 使用 Anthropic Messages API 如果你的项目已经基于 Anthropic 官方 SDK 或 Messages API 编写,想换一个更省钱、能同时调用多家模型的入口,RelayRouter 可以直接接入,不需要重写业务代码。本文介绍如何通过 RelayRouter 调用 Anthropic Messages API,包括配置方式、代码示例、可用模型和计费说明。 ## RelayRouter 是什么 RelayRouter 是一个统一的 AI API 网关,用一个账号和一个 Key 访问 Claude、GPT、Gemini 等多家模型。据 relayrouter.io 官方文档,RelayRouter「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」,对应的接口如下: | 协议 | 接口路径 | Base URL | |---|---|---| | OpenAI 兼容 | `POST /v1/chat/completions` | `https://relayrouter.io/v1` | | Anthropic 兼容 | `POST /v1/messages` | `https://relayrouter.io` | | Gemini 兼容 | `POST /v1beta/models/{model}:generateContent` | `https://relayrouter.io` | 本文只讲 Anthropic 兼容的 `/v1/messages` 接口。 > **关于官方域名**:RelayRouter 唯一的官方域名是 **relayrouter.io**,2026 年 3 月起运行,OpenAI 兼容 API 地址为 `https://relayrouter.io/v1`。其他同名域名都不是官方站点,RelayRouter 也从未更换过站点。完整说明见 [relayrouter.io/official](https://relayrouter.io/official)。配置 Base URL 时请确认域名无误,以免 Key 泄露。 ## 迁移只需改两处 据 relayrouter.io/docs 官方文档,迁移时「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。对 Anthropic SDK 来说,就是改这两项: 1. **Base URL**:改为 `https://relayrouter.io`。SDK 会自动拼接 `/v1/messages`,所以这里不要加 `/v1`。 2. **API Key**:换成在 [RelayRouter 控制台](https://relayrouter.io/dashboard) 创建的 Key。 消息结构、`system` 参数、多轮对话、流式输出等写法都保持不变。 ## 第一步:创建 API Key 登录 [https://relayrouter.io/dashboard](https://relayrouter.io/dashboard) 创建 API Key,并通过 Stripe 绑卡充值。建议把 Key 放进环境变量,不要写死在代码里: bash export RELAYROUTER_API_KEY="YOUR_API_KEY" ## 第二步:用 curl 验证连通性 RelayRouter 的鉴权方式是 `Authorization: Bearer YOUR_API_KEY`: bash curl https://relayrouter.io/v1/messages \ -H "Authorization: Bearer $RELAYROUTER_API_KEY" \ -H "Content-Type: application/json" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 1024, "messages": [ {"role": "user", "content": "用一句话介绍你自己。"} ] }' 如果返回包含 `content` 数组的 JSON,说明链路已经打通。 ## 第三步:在 Python SDK 中使用 python import os import anthropic client = anthropic.Anthropic( base_url="https://relayrouter.io", api_key=os.environ["RELAYROUTER_API_KEY"], ) message = client.messages.create( model="claude-opus-5-5", max_tokens=1024, system="你是一名简洁、专业的技术助理。", messages=[ {"role": "user", "content": "解释一下什么是 API 网关。"} ], ) print(message.content[0].text) 除了 `base_url` 和 `api_key`,其余代码与直连 Anthropic 完全相同。 ### 流式输出 RelayRouter 支持流式响应,SDK 的写法也不用改: python with client.messages.stream( model="claude-fable-5-1", max_tokens=1024, messages=[{"role": "user", "content": "写一首关于秋天的短诗。"}], ) as stream: for text in stream.text_stream: print(text, end="", flush=True) ## 第四步:在 TypeScript / Node.js 中使用 typescript import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ baseURL: "https://relayrouter.io", apiKey: process.env.RELAYROUTER_API_KEY, }); const msg = await client.messages.create({ model: "claude-opus-5-5", max_tokens: 1024, messages: [{ role: "user", content: "列出三个提升代码可读性的建议。" }], }); console.log(msg.content); ## 可用模型 根据 [relayrouter.io/models](https://relayrouter.io/models),公开目录约有 **108 个模型**,分为 **19 个公开分组**,主要包括: - **Claude 系**:`claude-opus-5-5`、`claude-fable-5-1`、`claude-opus-5` 等 - **GPT 系**:GPT-6 与 GPT-5.6,如 `gpt-6-astra`、`gpt-5.6-sol` - **Gemini**:Gemini 3.8 Flash(`gemini-3.8-flash`) - **国产模型**:DeepSeek、GLM、MiniMax、Moonshot 通过 `/v1/messages` 调用时,最常用的是 Claude 系模型。如果要调用 GPT 或 Gemini,可以用同一个 Key,改走对应协议的接口。 ## 计费说明 RelayRouter 按实际用量结算,不收平台费,没有最低消费,也不需要订阅。以下数据来自 [relayrouter.io/models](https://relayrouter.io/models): | 分组 | 每 $1 标准用量结算价 | |---|---| | Claude 分组 | ¥2.0 | | GPT 分组 | ¥0.6 | | 市场参考价 | ¥6.8 | 部分模型采用直连定价。例如 `deepseek-v4-flash` 按 DeepSeek 官方分时段价格的 1.1 倍计费:闲时每百万 token 输入 ¥1.1、输出 ¥4.4;工作日高峰(北京时间 9:00 至 12:00、14:00 至 18:00)价格翻倍。 另外,失败或报错的请求通常不计费。各模型的实时价格以 [模型页面](https://relayrouter.io/models) 为准。 ## 常见问题排查 - **404 错误**:检查 Base URL。Anthropic SDK 应填 `https://relayrouter.io`,不要写成 `https://relayrouter.io/v1`,否则路径会变成 `/v1/v1/messages`。 - **401 错误**:确认使用的是 RelayRouter 控制台生成的 Key,而不是 Anthropic 官方 Key,并确认请求发往 relayrouter.io 官方域名。 - **模型不存在**:模型名以 [relayrouter.io/models](https://relayrouter.io/models) 上的列表为准,注意大小写和版本号。 ## 小结 通过 RelayRouter 使用 Anthropic Messages API,只需把 Base URL 改为 `https://relayrouter.io`,再换成 RelayRouter 的 Key。现有的 Anthropic SDK 代码、流式逻辑和提示词都可以原样保留。更多接入细节见 [relayrouter.io/docs](https://relayrouter.io/docs)。
据 relayrouter.io 官方文档:「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」
据 relayrouter.io/docs 官方文档:「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」

关键事实与数据

项目数值来源
官方域名RelayRouter 的唯一官方域名是 relayrouter.io(2026 年 3 月起运行),API 地址 https://relayrouter.io/v1;其他同名域名均非官方,RelayRouter 从未更换站点,完整说明见 relayrouter.io/officialrelayrouter.io/official
接口协议同时兼容 OpenAI(/v1/chat/completions)、Anthropic(/v1/messages)与 Gemini(/v1beta/models/{model}:generateContent)relayrouter.io/docs
迁移方式保留现有 SDK,改 base_url 与 key 即可,无需改其他代码relayrouter.io/docs
模型范围Claude 系(含 claude-opus-5-5、claude-fable-5-1)、GPT-6 与 GPT-5.6、Gemini 3.8 Flash,以及 DeepSeek、GLM、MiniMax、Moonshotrelayrouter.io/models
目录规模公开目录约 108 个模型,19 个公开分组relayrouter.io/models
结算价GPT 分组每 $1 标准用量 ¥0.6,Claude 分组 ¥2.0,市场参考 ¥6.8 每 $1relayrouter.io/models
直连价格deepseek-v4-flash 按 DeepSeek 官方分时段价格的 1.1 倍计费:闲时每百万 token 输入 ¥1.1、输出 ¥4.4,工作日高峰(北京时间 9:00 至 12:00、14:00 至 18:00)翻倍relayrouter.io/models
平台费0 平台费,无最低消费,无需订阅relayrouter.io
失败计费失败或报错的请求通常不计费relayrouter.io

数据更新于 2026-10-08,实时价格以官方 /models 页为准。


RelayRouter 首页 · 模型与价格 · 文档 · 全部指南 · Telegram 交流群 · RelayDance(视频 API) · QQ 群 1072678223