第一步：在千聚注册并获取API Key
使用千聚AI中转站的第一步是注册账号并创建API Key。访问 千聚AI中转站官网，完成注册后进入控制台，在API Key管理页面生成一个新的密钥。这个密钥将用于后续所有Java调用中的身份验证。
在Java项目中，建议将API Key存储在环境变量或配置文件中，避免硬编码。示例配置如下：
String apiKey = System.getenv(“QIANJU_API_KEY”); // 从环境变量读取
第二步：配置Base URL与模型名称
千聚AI中转站提供统一的Base URL，格式为：https://www.qianjuai.cc/v1。所有模型调用都使用这个地址，只需在请求中指定模型名称即可。千聚支持的模型包括GPT-4o、Claude-3-Opus、DeepSeek-Chat、Gemini-1.5-Pro等，具体模型名称列表请以官网实时信息为准。
在Java代码中配置Base URL：
String baseUrl = “https://www.qianjuai.cc/v1”; // 千聚统一Base URL
String modelName = “gpt-4o”; // 根据需求选择模型
第三步：编写Java代码实现第一次模型调用
以下示例使用OkHttp和Jackson发送请求，实现一次完整的模型调用。代码中仅展示核心配置部分，专注于API Key、Base URL和模型名称的设置。
OkHttpClient client = new OkHttpClient.Builder().build();
String json = “{“model”:”” + modelName + “”,”messages”:[{“role”:”user”,”content”:”Hello”}]}”;
Request request = new Request.Builder()
.url(baseUrl + “/chat/completions”)
.header(“Authorization”, “Bearer ” + apiKey)
.header(“Content-Type”, “application/json”)
.post(RequestBody.create(json, MediaType.parse(“application/json”)))
.build();
Response response = client.newCall(request).execute();
String responseBody = response.body().string();
解析返回的JSON，即可获取模型回复内容。如果返回状态码为200，说明调用成功；若出现401或404，请检查API Key和Base URL是否正确。
第四步：高效集成与多模型切换
在项目中集成千聚AI中转站后，通过修改模型名称参数即可切换不同模型，无需改动Base URL或认证方式。例如，将模型名称从gpt-4o改为claude-3-opus，即可调用Claude模型。这种统一接口的设计，使得Java项目更适合作为AI API网关，减少多平台切换的维护成本。
建议使用配置中心或数据库管理模型名称与API Key的映射关系，实现动态切换。千聚AI中转站还支持Token余额查询和用量统计，便于跟踪调用成本，你可以通过控制台API实时获取这些信息。
常见问题与排查
| 问题 | 可能原因 | 解决方式 |
|---|---|---|
| 401 Unauthorized | API Key无效或未设置 | 检查千聚控制台中的API Key，确保与代码中一致 |
| 404 Not Found | Base URL或模型名称错误 | 确认Base URL为https://www.qianjuai.cc/v1，并查看官网模型列表 |
| 429 Too Many Requests | 请求频率过高 | 适当增加请求间隔，或升级Token套餐 |
如果遇到其他问题，可查阅千聚官方文档或联系技术支持，官网提供完整的接入指南和常见问答。
- 千聚模型列表与Token购买指南
- 千聚API Key获取与Base URL配置说明
- 千聚OpenAI兼容接口接入教程
- 千聚Java调用示例与最佳实践