Anthropic Python SDK 改 base_url 接入 RelayRouter 的方法

使用 Anthropic Python SDK 接入 RelayRouter,只需保留现有 SDK,把 base_url 指向 RelayRouter 的 Anthropic 兼容端点(基址 https://relayrouter.io,请求路径 POST /v1/messages),并把 API key 换成在 https://relayrouter.io/dashboard 创建的密钥即可。据 relayrouter.io/docs 官方文档,「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」,因此无需改动其他调用逻辑。

需要修改哪两处配置

接入只涉及两处修改: base_url 与 API key。据 relayrouter.io 官方文档,「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。在 Anthropic Python SDK 中,把 base_url 设为 https://relayrouter.io,请求会走 Anthropic 兼容路径 POST /v1/messages;认证使用 Authorization: Bearer YOUR_API_KEY,密钥在 https://relayrouter.io/dashboard 创建。其余的消息结构、参数名与流式(streaming)调用方式保持不变。完整的模型列表与协议说明见 https://relayrouter.io/models 与 https://relayrouter.io/docs。

接入步骤(4 步)

按以下 4 个步骤即可完成 Anthropic Python SDK 的接入。

1. 在 https://relayrouter.io/dashboard 创建 API key。
2. 初始化客户端时把 base_url 设为 https://relayrouter.io。
3. 把 api_key 换成 RelayRouter 的密钥,认证头为 Authorization: Bearer YOUR_API_KEY。
4. 选择目标模型(例如 claude-opus-4-8 或 claude-fable-5),按原有代码调用 POST /v1/messages,可开启 streaming。

支持的协议与模型范围

RelayRouter 同时提供多种协议兼容,并覆盖多家厂商的模型。据 relayrouter.io 官方文档,「同时兼容 OpenAI 与 Anthropic 两种协议」:OpenAI 兼容端点为 POST /v1/chat/completions(基址 https://relayrouter.io/v1),Anthropic 兼容端点为 POST /v1/messages(基址 https://relayrouter.io),Gemini 兼容端点为 POST /v1beta/models/{model}:generateContent。模型范围包括 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。

协议与端点对照

下表汇总三种协议对应的基址与请求路径,便于选择 Anthropic Python SDK 应指向的地址。

计费与费用说明

主流模型组的价格平均比官方标价低约 30 percent,且没有平台附加费。付款方式为 Stripe 卡支付。据 relayrouter.io 官方文档,失败或报错的请求通常不计费,因此调用出错时不会产生费用。认证统一使用 Authorization: Bearer YOUR_API_KEY,密钥在 https://relayrouter.io/dashboard 管理。由于接入仅需修改 base_url 与 key 两处,原有基于 Anthropic Python SDK 的项目可以在不改动其他代码的前提下切换到 RelayRouter,并继续使用 streaming 调用方式。

常见问题(FAQ)

问:接入 RelayRouter 需要改动多少处代码?

答:两处。把 base_url 指向 https://relayrouter.io,并把 API key 换成 RelayRouter 的密钥,其余代码无需改动。

问:Anthropic Python SDK 应使用哪个端点?

答:使用 Anthropic 兼容端点 POST /v1/messages,基址为 https://relayrouter.io。

问:请求失败会计费吗?

答:据 relayrouter.io 官方文档,失败或报错的请求通常不计费。