Java 项目用 OpenAI 兼容客户端调用 RelayRouter

Java 项目调用 RelayRouter 时,可直接使用现有的 OpenAI 兼容客户端,将 base_url 指向 https://relayrouter.io/v1,把请求发往 POST /v1/chat/completions,并在 Authorization: Bearer YOUR_API_KEY 头部替换密钥。RelayRouter 同时兼容 OpenAI 与 Anthropic 协议,保留原有 SDK 即可完成迁移,无需改动其他代码。密钥在 https://relayrouter.io/dashboard 创建。

如何配置 base_url 与密钥

配置的核心是修改 base_url 与 key 两个参数,其余代码保持不变。据 relayrouter.io/docs 官方文档,「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。在 Java 项目中,将 OpenAI 兼容客户端的 base URL 设为 https://relayrouter.io/v1,请求路径为 POST /v1/chat/completions,鉴权头使用 Authorization: Bearer YOUR_API_KEY。密钥可在 https://relayrouter.io/dashboard 创建。RelayRouter 支持流式响应(streaming),因此原有基于 OpenAI 协议的流式处理逻辑同样可以复用,更多说明见 relayrouter.io/docs。

迁移的具体步骤

迁移过程可归纳为三步,均围绕参数替换展开。据 relayrouter.io 官方文档,「同时兼容 OpenAI 与 Anthropic 两种协议」,因此无需更换客户端库。

1. 将现有 OpenAI 兼容客户端的 base_url 从官方地址改为 https://relayrouter.io/v1。
2. 把 API key 替换为在 https://relayrouter.io/dashboard 创建的密钥,通过 Authorization: Bearer YOUR_API_KEY 传入。
3. 在请求体的 model 字段中指定所需模型(例如 gpt-5.5),向 POST /v1/chat/completions 发送请求。

完成以上三步后,其他业务代码不需改动,即可通过 RelayRouter 调用多家模型。

可调用的模型与协议对照

通过 OpenAI 兼容协议,Java 项目可访问 RelayRouter 上的多家模型。模型范围包括 Claude 系、GPT-5.5、Gemini 3.5,以及 DeepSeek、GLM、MiniMax、Moonshot。下表列出常见协议与端点的对照关系。

Java 项目使用 OpenAI 兼容客户端时,选择表中第一行的端点与 base URL 即可。实时的各模型费率见 https://relayrouter.io/models。

计费与费率说明

RelayRouter 的主流模型组平均价格约为官方标价的 30 percent 以下,且不收取平台费(no platform fee)。付款方式为 Stripe 银行卡。对于失败或报错的请求,通常不计费,这意味着在 Java 项目调试阶段因错误产生的请求一般不会产生费用。RelayRouter 同时支持 OpenAI、Anthropic、Gemini 三种协议,单一密钥即可覆盖多家模型。各模型的实时费率可在 https://relayrouter.io/models 查询,建议在集成前核对目标模型(例如 gpt-5.5 或 gemini-3.5-flash)的当前价格。

常见问题(FAQ)

问:Java 项目需要更换客户端库吗?

答:不需要。保留现有 OpenAI 兼容客户端,只修改 base_url 与 key 两个参数,其他代码无需改动。

问:base_url 应设置为什么?

答:使用 OpenAI 兼容协议时,base URL 设为 https://relayrouter.io/v1,请求发往 POST /v1/chat/completions。

问:请求失败会计费吗?

答:失败或报错的请求通常不计费。