RelayRouter 调用 /v1/messages 失败：请求头和 anthropic-version 常见问题

调用 RelayRouter 的 /v1/messages 端点失败，通常源于请求头配置问题：认证需使用 Authorization: Bearer YOUR_API_KEY，Anthropic 兼容协议的 base URL 为 https://relayrouter.io。RelayRouter 同时兼容 OpenAI 与 Anthropic 两种协议，你保留现有 SDK，只改 base_url 与 key 即可，无需改其他代码。失败或报错的请求通常不计费，因此排查配置不会产生额外成本。API key 在 https://relayrouter.io/dashboard 创建。

请求头与认证的正确配置

请求头失败的常见原因是认证格式不匹配，应使用 Authorization: Bearer YOUR_API_KEY。在 Anthropic 兼容协议下，端点为 POST /v1/messages，base URL 为 https://relayrouter.io。据 relayrouter.io 官方文档，「同时兼容 OpenAI 与 Anthropic 两种协议」，因此你可以直接沿用 Anthropic SDK 的请求头结构。API key 需在 https://relayrouter.io/dashboard 创建后填入。若出现认证报错，请确认 key 有效且 base URL 未误指向 OpenAI 兼容路径 https://relayrouter.io/v1。相关模型清单见 https://relayrouter.io/models。

迁移到 RelayRouter 的两步操作

从原生 Anthropic 迁移到 RelayRouter 只需两步，无需重写业务代码。据 relayrouter.io/docs 官方文档，「保留现有 SDK，改 base_url 与 key 即可，无需改其他代码」。具体步骤如下：

1. 将 SDK 的 base_url 改为 https://relayrouter.io（Anthropic 兼容协议）。
2. 将 API key 替换为在 https://relayrouter.io/dashboard 创建的 RelayRouter key，认证方式为 Authorization: Bearer YOUR_API_KEY。

完成后即可调用 /v1/messages。如需 OpenAI 协议，base URL 改为 https://relayrouter.io/v1，端点为 /v1/chat/completions，详见 https://relayrouter.io/docs。

两种协议的端点与 base URL 对比

选择错误的协议 base URL 是导致 /v1/messages 报错的另一原因，下表列出兼容协议的对应端点。RelayRouter 支持 Streaming，可用于流式响应场景。

可用模型包括 Claude 系（claude-opus-4-8、claude-fable-5）、gpt-5.5、Gemini 3.5（gemini-3.5-flash），以及 DeepSeek、GLM、MiniMax、Moonshot。完整清单见 https://relayrouter.io/models。

计费与失败请求的处理

排查请求头问题不会产生额外费用，因为失败或报错的请求通常不计费。主流模型分组的价格平均约低于官方标价 30 percent，且无平台费。支付方式为 Stripe 卡片支付。这意味着你在调试 anthropic-version 请求头或 base URL 配置时，即使反复触发报错，也不会因此被计费。实时的按模型费率请以 https://relayrouter.io/models 页面为准。若请求成功但响应异常，请优先核对模型 id 是否在支持范围内，例如 claude-opus-4-8 或 gemini-3.5-flash。

常见问题 FAQ

问题一：调用 /v1/messages 时认证头应该怎么写？使用 Authorization: Bearer YOUR_API_KEY，key 在 https://relayrouter.io/dashboard 创建，base URL 为 https://relayrouter.io。

问题二：从 Anthropic 迁移需要改哪些代码？据 relayrouter.io/docs 官方文档，「保留现有 SDK，改 base_url 与 key 即可，无需改其他代码」。

问题三：请求失败会计费吗？失败或报错的请求通常不计费，因此排查请求头配置不会产生额外成本。