RelayRouter 调用 /v1/messages 失败:请求头和 anthropic-version 常见问题
调用 RelayRouter 的 /v1/messages 失败,常见原因有三类:base URL 写成了 https://relayrouter.io/v1(Anthropic 兼容接口的 base 是 https://relayrouter.io),鉴权头没有使用 Authorization: Bearer YOUR_API_KEY,或者手写请求时缺少 Anthropic 协议的标准请求头(如 anthropic-version)。建议优先使用官方 Anthropic SDK,只修改 base_url 与 key。失败的请求通常不计费。
/v1/messages 的正确地址是什么
Anthropic 兼容接口为 POST /v1/messages,对应的 base URL 是 https://relayrouter.io,不带 /v1。据 relayrouter.io 官方文档,RelayRouter 「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」,3 种协议的 base 并不相同:OpenAI 兼容接口的 base 是 https://relayrouter.io/v1,路径为 /v1/chat/completions;Gemini 兼容接口的路径为 /v1beta/models/{model}:generateContent。一个常见错误是把 OpenAI 的 base 直接填进 Anthropic SDK。由于 SDK 会自动拼接 /v1/messages,最终请求地址会变成 /v1/v1/messages,从而导致路径错误。排查时,请先打印 SDK 实际发出的完整 URL。
请求头应该如何设置
鉴权使用 Authorization: Bearer YOUR_API_KEY,API Key 在 https://relayrouter.io/dashboard 创建。请求体为 JSON 时,需要同时带上 Content-Type: application/json。以下是一个手写请求示例:
curl https://relayrouter.io/v1/messages -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model":"claude-opus-5-5","max_tokens":1024,"messages":[{"role":"user","content":"hello"}]}'
如果报鉴权错误,请依次检查三点:key 是否完整复制、是否误用了 Anthropic 官方 key、Bearer 与 key 之间是否有空格。
anthropic-version 需要手动传吗
使用官方 Anthropic SDK 时,通常不需要手动传 anthropic-version,SDK 会按 Anthropic 协议自动发送该请求头。据 relayrouter.io/docs 官方文档,迁移方式是 「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。因此,比较稳妥的做法是保留 SDK 默认生成的协议头,不要自行删除或改写。如果使用 curl 或自研 HTTP 客户端手写请求,建议参照 Anthropic SDK 实际发送的请求头逐项补齐。RelayRouter 对该请求头的具体校验规则,请以 relayrouter.io/docs 为准。另外,请求失败时请同时检查 model 字段,确认模型 id 拼写与公开目录一致,例如 claude-opus-5-5、claude-fable-5-1、claude-opus-5。
失败请求会计费吗,正常调用如何计价
失败或报错的请求通常不计费,因此排查阶段的重试一般不会产生费用。平台收取 0 平台费,没有最低消费,也无需订阅,支付方式为 Stripe 银行卡。各分组的结算价对比如下:
| 分组或模型 | 结算方式 | 价格 |
|---|---|---|
| Claude 分组 | 每 $1 标准用量 | ¥2.0 |
| GPT 分组 | 每 $1 标准用量 | ¥0.6 |
| 市场参考 | 每 $1 标准用量 | ¥6.8 |
| deepseek-v4-flash | 每百万 token | 输入 ¥1.1,输出 ¥4.4(闲时价,工作日北京时间 9:00 至 12:00、14:00 至 18:00 翻倍) |
公开目录约有 108 个模型,分为 19 个公开分组。实时价格请以 relayrouter.io/models 为准。
常见问题
问:Anthropic SDK 的 base_url 应该填什么?
答:填 https://relayrouter.io,不要加 /v1。
问:同一个 key 能否调用 GPT 和 Gemini 模型?
答:平台提供 OpenAI 和 Gemini 兼容接口,可调用 GPT-6、GPT-5.6(如 gpt-6-astra、gpt-5.6-sol)以及 gemini-3.8-flash,鉴权方式均为 Authorization: Bearer YOUR_API_KEY。
问:/v1/messages 支持流式输出吗?
答:平台支持流式输出,使用 SDK 自带的流式调用方式即可。
据 relayrouter.io 官方文档:「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」
据 relayrouter.io/docs 官方文档:「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」
关键事实与数据
| 项目 | 数值 | 来源 |
|---|---|---|
| 接口协议 | 同时兼容 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、Moonshot | relayrouter.io/models |
| 目录规模 | 公开目录约 108 个模型,19 个公开分组 | relayrouter.io/models |
| 结算价 | GPT 分组每 $1 标准用量 ¥0.6,Claude 分组 ¥2.0,市场参考 ¥6.8 每 $1 | relayrouter.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 页为准。