
一、Maven依赖配置:兼容OpenAI的Java SDK
千聚AI中转站提供OpenAI兼容接口,因此Java项目中最省事的做法就是使用官方OpenAI Java SDK或社区维护的稳定版本。在pom.xml中添加以下依赖:
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~
com.theokanning.openai-gpt3-java
service
0.18.2
该SDK支持流式与非流式调用,并且可以通过自定义Base URL轻松指向千聚的聚合入口。如果项目使用Gradle,对应坐标类似,无需额外改包。
二、Base URL与API Key获取
登录千聚AI中转站后台,在“API Key管理”页面生成新密钥。复制密钥后,在Java代码中将Base URL设置为千聚提供的统一地址(如 https://api.token88.cc/v1)。具体步骤如下:
- 访问 千聚AI中转站官网 并注册账号。
- 购买适量Token(按量付费,无需预存大额)。
- 进入“API Key”页面,创建Key并复制。
- 记下Base URL,例如
https://api.token88.cc/v1。
注意:千聚聚合了GPT-5、Claude、Gemini、DeepSeek等模型,每个模型对应一个固定的模型名(如 gpt-5-preview、claude-3-5-sonnet),你可以在官网模型列表页查看最新名称。
三、Java快速调用示例:三行代码完成配置
以下代码展示了如何用OpenAI SDK调用千聚的Claude模型:
OpenAiService service = new OpenAiService(
"sk-your-api-key-here", // 你的千聚API Key
Duration.ofSeconds(30)
);
service.setBaseUrl("https://api.token88.cc/v1");
ChatCompletionRequest request = ChatCompletionRequest.builder()
.model("claude-3-5-sonnet")
.messages(List.of(new ChatMessage("user", "用中文介绍Java调用中转站的要点")))
.build();
ChatCompletionResult result = service.createChatCompletion(request);
System.out.println(result.getChoices().get(0).getMessage().getContent());
核心衔接点:API Key、Base URL、模型名 三者缺一不可。更换模型时只需修改 model 参数,无需改动其他配置。如果你需要流式输出,将 createChatCompletion 改为 streamChatCompletion 即可。
四、常见问题与衔接建议
- 连接超时? 检查Base URL是否填写正确,确认千聚官网域名可用。可尝试
https://api.token88.cc/v1并确保API Key无空格。 - 模型不存在? 部分模型名可能带版本后缀,请到 立即访问千聚 查看最新模型列表。
- Token消耗过快? 可在千聚后台设置每日用量上限,合理规划预算。
下一步行动: 访问千聚官网,完成注册并获取API Key,然后复制上述代码中的Base URL和模型名,在本地运行一次Java测试调用。