
第一步:注册千聚账号并获取API Key
使用大模型中转站Java调用的前提是拥有一个稳定的中转站账号。千聚AI中转站提供了简洁的注册流程,支持邮箱快速注册。注册完成后,进入控制台个人中心,即可创建API Key。
获取到API Key后,建议先保存到安全的地方,后续Java代码中会直接使用。
第二步:确认Base URL与模型名称
千聚平台提供统一的OpenAI兼容接口,Base URL固定为 https://api.token88.cc/v1,无需针对不同模型修改地址。模型名称采用标准命名格式,例如 gpt-4o、claude-3-opus、gemini-2.0-pro 等。具体支持的模型列表可到官网文档页查看。
对于Java开发者,最关键的三个配置参数如下:
| 参数 | 示例值 | 说明 |
|---|---|---|
| API Key | sk-xxxxxxxxxxxxxxxxxx |
在千聚控制台生成的密钥 |
| Base URL | https://api.token88.cc/v1 |
统一调用入口 |
| Model | gpt-4o |
根据需求选择模型名称 |
注意:Base URL末尾的 /v1 是必需的,OpenAI Java SDK默认会拼接路径。
第三步:Java代码调用示例(OpenAI SDK)
千聚完全兼容OpenAI的Java客户端库,推荐使用 com.openai:openai-java 或 io.github.cdimascio:openai-java。以下是一个最简单的文本补全示例:
import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.ChatModel;
import com.openai.models.chat.completions.ChatCompletionCreateParams;
import com.openai.models.chat.completions.ChatCompletion;
public class QianJuDemo {
public static void main(String[] args) {
OpenAIClient client = OpenAIOkHttpClient.builder()
.apiKey("sk-您获取的API Key")
.baseUrl("https://api.token88.cc/v1")
.build();
ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
.model(ChatModel.of("gpt-4o"))
.addUserMessage("你好,请用中文回复")
.build();
ChatCompletion response = client.chat().completions().create(params);
System.out.println(response.choices().get(0).message().content().orElse(""));
}
}
代码中仅需修改 apiKey 和 baseUrl 两个配置,模型名称可按需切换。运行后即可收到千聚中转站返回的响应结果。整个接入过程与调用官方OpenAI几乎一致,但实际访问的是千聚的多模型聚合集群。
第四步:购买Token并检查用量
API Key创建后,账户余额为空,无法直接发起调用。您需要先购买Token。在千聚控制台找到“Token购买”或“充值”模块,选择合适的套餐。千聚支持按量计费,使用多少扣多少,无月费无隐藏费用。
同时,平台提供实时用量统计,可在“调用记录”中查看每小时的请求次数、消耗Token数及响应耗时。建议定期检查,避免因余额不足导致服务中断。
常见问题与调试建议
- 连接超时:确保网络能正常访问
https://api.token88.cc,部分内网环境需配置代理。 - 401认证错误:检查API Key是否复制完整,是否有空格或换行。
- 404模型不存在:确认模型名称是否在千聚支持的列表中,大小写需匹配。
- 余额不足:请到官网购买Token。建议先小额测试,成功后增加用量。
整体来看,大模型中转站Java调用与OpenAI接口对接并不复杂。只要正确配置API Key、Base URL和模型名,就能在Java项目中获得多模型切换能力。千聚AI中转站通过统一接口,让开发者无需维护多个SDK,显著降低接入和维护成本。
立即开始你的第一次调用
访问 千聚AI中转站官网,注册账号 → 创建API Key → 购买Token → 粘贴上方Java代码并运行。只需几分钟,你就能完成大模型中转站Java调用与OpenAI接口对接的全流程。支持GPT-5、Claude、Gemini、DeepSeek、Qwen等主流模型,一次接入,长期复用。
如果你在代码集成过程中遇到任何问题,千聚官网提供了详细的API文档和社区讨论区。无论你使用的是Spring Boot、Micronaut还是纯Java项目,以上示例均可直接移植。现在就动手试试吧。