一、注册账号并获取API Key
在进行任何代码开发前,你首先需要一个可用的平台账号。千聚AI中转站为开发者提供了简洁的注册流程,你只需前往官网完成注册,即可在后台管理页面轻松生成专属的API Key。
步骤如下:
- 访问 千聚AI中转站官网,完成账号注册与登录。
- 进入“API Key管理”页面,点击新建密钥,系统会生成一串以“sk-”开头的密钥。
- 复制并妥善保存该密钥,这是你在后续Java代码中调用模型的唯一身份凭证。
二、配置Java项目的核心依赖与Base URL
千聚AI中转站提供的是完全兼容OpenAI接口的API,这意味着你无需额外引入复杂的SDK,直接使用主流的Java HTTP客户端库即可。以下是你需要在Java代码中配置的三个关键元素:
| 配置项 | 说明 | 示例值 |
|---|---|---|
| Base URL | 千聚提供的统一接入地址 | https://www.qianjuai.cc/v1 |
| API Key | 你在平台生成的密钥 | sk-xxxxxxxxxxxxx |
| Model | 你想要调用的模型名称 | gpt-4o 或 claude-sonnet-4-20250514 |
在Java项目中,建议将Base URL和API Key统一配置在application.properties或环境变量中,便于后期维护和切换模型。例如:
application.properties
openai.base-url=https://www.qianjuai.cc/v1
openai.api-key=sk-你获取的密钥
openai.model=gpt-4o
三、编写Java代码:发送一次模型调用
利用千聚的AI聚合能力,你可以在Java中通过OkHttp或RestTemplate等工具,向统一的Base URL发送标准的OpenAI格式请求。以下是一个基于OkHttp的极简调用示例,它演示了如何发送对话请求并接收回复:
import okhttp3.*;
import org.json.JSONObject;
import java.io.IOException;
public class AIApiClient {
public static void main(String[] args) throws IOException {
String apiKey = "sk-你的密钥";
String baseUrl = "https://www.qianjuai.cc/v1chat/completions";
JSONObject requestBody = new JSONObject();
requestBody.put("model", "gpt-4o");
JSONObject message = new JSONObject();
message.put("role", "user");
message.put("content", "用Java写一个冒泡排序示例");
requestBody.put("messages", new JSONObject[]{message});
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url(baseUrl)
.header("Authorization", "Bearer " + apiKey)
.header("Content-Type", "application/json")
.post(RequestBody.create(requestBody.toString(), MediaType.parse("application/json")))
.build();
try (Response response = client.newCall(request).execute()) {
System.out.println(response.body().string());
}
}
}
这段代码的核心逻辑非常简单:只需要修改baseUrl和apiKey,即可让原本针对OpenAI的Java代码无缝接入千聚平台,进而访问GPT-4、Claude、Gemini、DeepSeek等数十种主流模型。这正是AI聚合平台Java调用的核心优势——一次接入,多模型可用。
四、在千聚平台管理与切换模型
当你的Java项目使用千聚API时,唯一需要动态调整的参数就是模型名称(Model)。千聚AI中转站在后台提供了完整的模型列表和实时可用状态,你可以随时切换模型而无需修改任何Java代码。这种架构极大地降低了AI应用的开发成本和维护复杂度。
无论是想试用最新的GPT-5系列,还是需要切换到更适合中文问答的Qwen或Kimi,你只需在代码中将model参数变更为对应的千聚模型标识符即可。
五、购买Token与查看余额
为了确保调用的连续性,千聚采用按量计费的Token购买模式。当你完成首次Java调用后,建议在官网查看当前余额并补充足够的Token。由于每个模型的计费标准可能不同,具体的Token价格和充值入口请以官网实时展示为准。
你可以通过以下方式管理账户:
- 在控制台首页查看余额和Token消耗详情。
- 购买Token时选择适合自己项目规模的套餐。
- 设置告警阈值,在余额不足时及时收到通知。
立即开始你的AI聚合平台Java调用之旅
通过本文的教程,你已经了解了从获取API Key到完成Java代码调用的完整路径。千聚AI中转站不仅为你提供了稳定的聚合接入能力,还通过统一接口大幅降低了多模型集成的技术门槛。现在,就是动手实践的最佳时机。
下一步行动建议:
- 前往 立即访问千聚 注册账号并获取你的专属API Key。
- 在官网上浏览完整的模型列表,找到最适合你项目的模型。
- 将上述Java代码中的url和apiKey替换为千聚的实际配置,完成你的第一次模型调用。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~