接入AI模型最关键的三件事:API Key、Base URL和模型名称。对于Java开发者来说,通过千聚AI中转站官网可以一站式完成多模型调用,无需逐个对接不同厂商。本文将带你从环境配置开始,逐步完成Java调用AI API中转站的完整流程,帮你快速集成GPT、Claude、DeepSeek等主流模型。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~
第一步:准备工作——获取千聚API Key和Base URL
在编写Java代码之前,你需要先拥有一个千聚账号。访问立即访问千聚注册并登录,然后进入API Key管理页面创建密钥。千聚的Base URL格式为:https://api.token88.cc/v1。你还可以在模型列表中查看支持的所有模型名称(如gpt-4o、claude-sonnet-4、deepseek-chat等)。
注意事项:
- API Key请妥善保管,切勿泄露。
- 首次使用建议先购买少量Token(前往官网查看实时价格),用于测试调用。
- 千聚兼容OpenAI接口格式,因此后续Java代码可直接使用OpenAI官方SDK或OkHttp等工具。
第二步:Java项目环境配置
本教程使用Maven项目,需要引入必要的依赖。在pom.xml中添加以下内容:
com.theokanning.openai-gpt3-java
service
0.18.2
如果你希望更轻量,也可以直接使用OkHttp + Jackson。以下示例采用官方OpenAI Java SDK(已兼容千聚中转站)。
第三步:编写Java调用代码
以下是一个简洁的Java类,演示如何通过千聚中转站调用AI模型:
import com.theokanning.openai.OpenAiService;
import com.theokanning.openai.completion.chat.;
import java.util.Arrays;
public class QianJuDemo {
public static void main(String[] args) {
//
设置API Key和Base URL
String apiKey = "sk-你的千聚API密钥";
String baseUrl = "https://api.token88.cc/v1";
OpenAiService service = new OpenAiService(apiKey, baseUrl, Duration.ofSeconds(60));
//
构建消息
ChatMessage userMsg = new ChatMessage(ChatMessageRole.USER.value(), "用Java写一个快速排序算法");
ChatCompletionRequest request = ChatCompletionRequest.builder()
.model("gpt-4o") // 千聚支持的模型名,可在官网查看
.messages(Arrays.asList(userMsg))
.maxTokens(500)
.build();
//
发送请求并获取回复
service.createChatCompletion(request).getChoices().forEach(choice -> {
System.out.println(choice.getMessage().getContent());
});
}
}
代码要点说明:
- Base URL:必须设置为千聚的
https://api.token88.cc/v1。 - Model:可以直接使用千聚支持的模型标识,无需关心底层提供商。
- API Key:从千聚后台复制,注意不要包含空格。
第四步:运行测试与常见问题排查
运行上述代码前,请确保网络能正常访问千聚服务器。如果遇到连接超时或401错误,请核对以下项目:
| 错误类型 | 可能原因 | 解决方法 |
|---|---|---|
| 401 Unauthorized | API Key错误或过期 | 在千聚后台重新生成密钥 |
| 404 Not Found | 模型名称不正确 | 查阅千聚模型列表,使用正确模型ID |
| 403 Forbidden | Token余额不足 | 登录官网购买Token充值 |
千聚作为聚合平台,支持随时切换同一个API Key下的模型(如从GPT切换到Claude),只需修改代码中的model参数即可,非常便于统一管理。
进阶技巧:流式调用与错误重试
如果你需要实时流式输出,可以使用streamChatCompletion方法,并在回调中处理每个token。千聚同样兼容流式接口。另外,建议在代码中加入指数退避的重试机制,以应对临时网络抖动。以下是一个简化的重试示例:
int retries = 3;
while (retries-
> 0) {
try {
// 发送请求...
break;
} catch (Exception e) {
Thread.sleep(1000 (3
retries));
}
}
CTA:现在就开始你的第一次调用
通过以上步骤,你已经掌握了Java调用AI API中转站的核心流程。下一步,请立即访问千聚官网,获取你的专属API Key,并查看完整的模型列表与Token购买方案。无论你是个人开发者还是企业团队,千聚都能帮你降低多平台接入复杂度,更专注于业务本身。
前往千聚AI中转站官网注册 →