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

Java 项目可以继续使用现有的 OpenAI 兼容客户端（例如 openai-java SDK 或 java.net.http.HttpClient）调用 RelayRouter。只需把 base URL 改为 https://relayrouter.io/v1，并将 API Key 换成在 https://relayrouter.io/dashboard 创建的密钥，请求路径为 POST /v1/chat/completions，鉴权方式为 Authorization: Bearer YOUR_API_KEY，其他业务代码无需修改。

RelayRouter 支持哪些接口协议

RelayRouter 同时提供 OpenAI、Anthropic 与 Gemini 三种兼容接口，Java 项目使用 OpenAI 兼容接口即可。据 relayrouter.io 官方文档，该网关「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」，三种协议的端点如下：OpenAI 兼容为 POST /v1/chat/completions（base 为 https://relayrouter.io/v1），Anthropic 兼容为 POST /v1/messages（base 为 https://relayrouter.io），Gemini 兼容为 POST /v1beta/models/{model}:generateContent。对于已经接入 OpenAI 格式的 Java 服务，选择第一种协议改动量较小。接口支持流式输出，因此原有的 streaming 调用逻辑也可以沿用。完整说明见 relayrouter.io/docs。

在 Java 中如何完成接入

接入过程只涉及 base URL 与 API Key 两项配置。据 relayrouter.io/docs 官方文档，迁移方式为「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。以 openai-java SDK 为例，可按以下步骤操作：

1. 在 https://relayrouter.io/dashboard 创建 API Key，并保存到环境变量，例如 RELAYROUTER_API_KEY。
2. 构建客户端：OpenAIClient client = OpenAIOkHttpClient.builder().apiKey(System.getenv("RELAYROUTER_API_KEY")).baseUrl("https://relayrouter.io/v1").build();
3. 构建请求参数并指定模型 id：ChatCompletionCreateParams params = ChatCompletionCreateParams.builder().model("gpt-5.6-sol").addUserMessage("你好").build();
4. 发送请求：ChatCompletion completion = client.chat().completions().create(params);
5. 如果使用原生 HttpClient，向 https://relayrouter.io/v1/chat/completions 发送 POST 请求，并设置请求头 Authorization: Bearer YOUR_API_KEY 与 Content-Type: application/json。

可以调用哪些模型

通过同一个 OpenAI 兼容客户端，可以调用 Claude、GPT、Gemini 以及多家国产模型。根据 relayrouter.io/models，公开目录约有 108 个模型，分为 19 个公开分组。可用模型包括 Claude 系（claude-opus-5-5、claude-fable-5-1、claude-opus-5）、GPT-6 与 GPT-5.6（gpt-6-astra、gpt-5.6-sol）、Gemini 3.8 Flash（gemini-3.8-flash），以及 DeepSeek、GLM、MiniMax、Moonshot。在 Java 代码中切换模型时，只需修改 model 参数的取值，客户端配置保持不变。具体的模型 id 与实时价格以模型页面为准。

费用如何计算

RelayRouter 按实际用量结算，0 平台费，无最低消费，也无需订阅。下表为 relayrouter.io/models 列出的部分结算价：

据 relayrouter.io，失败或报错的请求通常不计费，支付方式为 Stripe 银行卡。

常见问题

问：Java 项目需要更换 SDK 吗？
答：不需要。保留现有的 OpenAI 兼容 SDK，只修改 base URL 为 https://relayrouter.io/v1 并替换 API Key。

问：OpenAI 兼容客户端能调用 Claude 模型吗？
答：可以。在 model 参数中填写 Claude 系模型 id（如 claude-opus-5-5）即可，可用模型列表见 relayrouter.io/models。

问：请求失败会产生费用吗？
答：据 relayrouter.io，失败或报错的请求通常不计费，平台也不收取平台费。