在使用千聚AI中转站进行Java调用前，需要先拥有一个账户和有效的API Key。只需在千聚官网完成注册，即可在后台创建并复制自己的API Key。这一步是所有调用的起点，配置时会直接用到。
立即访问 千聚AI中转站官网 注册账号，然后进入「API Key管理」页面生成一个新的Key。建议将Key保存在服务端的环境变量中，避免硬编码。
二、Java项目添加依赖
千聚兼容OpenAI的接口格式，因此Java开发者可以使用任何支持OpenAI API的HTTP客户端，例如OkHttp、RestTemplate，或者直接使用官方OpenAI Java SDK。这里推荐官方SDK，配置简单，社区活跃。
在pom.xml中添加依赖（Maven）：
com.theokanning.openai-gpt3-java
service
0.14.0
如果使用Gradle，可对应添加。
三、配置Base URL和API Key
千聚的Base URL与OpenAI官方不同，需要在客户端初始化时手动替换。Java调用中最关键的两个参数就是Base URL和API Key，设置正确才能成功连接。
String baseUrl = "https://api.token88.cc/v1"; // 千聚统一入口
String apiKey = System.getenv("QIANJU_API_KEY"); // 从环境变量读取
OpenAiService service = new OpenAiService(apiKey, baseUrl, Duration.ofSeconds(30));
注意：千聚的Base URL固定为上述地址，无需区分模型。模型名称在请求时指定即可。
四、Java调用模型示例
以千聚支持的GPT-4o-mini模型为例，发送一次对话请求：
List messages = new ArrayList();
messages.add(new ChatMessage(ChatMessageRole.USER, "Hello, 千聚！"));
ChatCompletionRequest request = ChatCompletionRequest.builder()
.model("gpt-4o-mini") // 千聚支持的模型名，请参考官网文档
.messages(messages)
.build();
ChatCompletionResult result = service.createChatCompletion(request);
result.getChoices().forEach(choice -> {
System.out.println(choice.getMessage().getContent());
});
其他模型如Claude 3.5 Sonnet、DeepSeek-V3等只需将model字段换成对应的模型名称即可。具体模型列表可到千聚官网查看更新。
五、常见错误排查
如果调用返回401错误，大概率是API Key不正确或Base URL拼写错误。请检查以下几点：
- Base URL必须以
/v1结尾，例如https://api.token88.cc/v1 - API Key不要包含多余空格或换行符
- 确认账户内有足够的Token余额（可在千聚后台查看并购买Token）
千聚的接口与OpenAI完全兼容，大部分流行开源框架（如LangChain4j、Spring AI）都能直接配置后使用，只需修改Base URL和API Key即可复用现有代码。
相关资源：