第一步：注册千聚账号并获取API Key
任何接入操作都从获取访问凭证开始。请按以下步骤准备：
- 打开 千聚AI中转站官网，完成注册并登录。
- 在控制台左侧菜单找到“API Key管理”，点击“创建新Key”。建议为知识库系统单独命名，方便后续管理。
- 复制生成的API Key字符串，同时记下页面显示的Base URL（通常为
https://www.qianjuai.cc/v1，具体以官网实时信息为准）。 - 根据需要购买适量Token，按量使用，避免浪费。
注意：API Key是敏感信息，请妥善保管，切勿明文提交到代码仓库中。建议通过环境变量注入。
第二步：在知识库系统中配置模型接入
不同知识库系统的配置入口略有差异，但核心参数一致。以下是一段典型的Python配置示例，仅展示三个关键字段：
openai.api_key = "你的千聚API Key"
openai.base_url = "https://www.qianjuai.cc/v1"
model_name = "gpt-4o" # 可根据需要选择，如claude-3-opus、deepseek-chat等
在知识库系统的设置页面中，通常可以找到“自定义模型”或“第三方API”选项，将上述三个参数填入对应位置即可。如果你使用的框架原生支持OpenAI格式（如LangChain、LlamaIndex），直接将千聚的Base URL和Key传入即可完成对接。
千聚的优势在于：你只需维护一套API Key和Base URL，就能切换上百种模型，无需为每个模型单独申请凭证、单独管理余额。这对于需要频繁测试不同模型效果的知识库场景来说，可以显著简化开发流程。
第三步：测试调用并验证连通性
配置完成后，建议先发送一个简单请求来确认接入是否成功：
- 确保网络环境可以访问
https://www.qianjuai.cc/v1（国内用户通常可直接连接）。 - 在知识库系统的内置测试工具中，发送一条消息（例如“你好，请自我介绍”），观察返回结果。
- 如果返回401错误，请检查API Key是否复制完整且未被篡改。
- 如果返回404，请确认模型名称是否存在于千聚支持的列表中（可到官网查看最新模型清单）。
常见问题排查：
| 错误现象 | 可能原因 | 解决方法 |
|---|---|---|
| Authentication failed | API Key无效或已过期 | 在千聚控制台重新生成Key |
| Model not found | 模型名称拼写错误或不可用 | 对照官网模型列表修正 |
| Rate limit exceeded | Token额度不足或并发超限 | 补充Token或降低请求频率 |
一旦测试通过，你的知识库系统就可以通过千聚调用多种AI模型了。后续可以根据业务需求灵活切换模型，无需再次修改接口配置。
如果您想进一步探索，以下内容可能对您有帮助：