第一步：注册并购买Token
在使用千聚AI中转站之前，你需要拥有一个账户并预充Token以支付API调用费用。整个过程可以在几分钟内完成：
- 访问 立即访问千聚 并注册账号（支持邮箱或手机号）。
- 登录后进入“Token购买”页面，选择适合的套餐。千聚提供多档位额度，按量计费，未用完的Token长期有效。
- 支付完成后，进入“API Key管理”页面，生成一个新的API Key。请妥善保存，后续配置会用到。
注意：不同模型消耗Token的速度不同，建议先从小额套餐开始测试，根据实际使用量再决定是否扩容。
第二步：获取关键配置参数
千聚AI中转站完全兼容OpenAI的接口格式，因此你只需要三个参数就能在任何支持OpenAI SDK的环境里调用模型：
| 参数 | 说明 | 示例值 |
|---|---|---|
| API Key | 上一步生成的密钥 | sk-xxxxxxxxxxxxxxxx |
| Base URL | 千聚提供的统一请求地址 | https://www.qianjuai.cc/v1 |
| Model Name | 所需模型标识，如gpt-4o、claude-3-opus、deepseek-chat | gpt-4o |
在Python中，配置方式非常简洁：
from openai import OpenAI
client = OpenAI(
api_key="你的API Key",
base_url="https://www.qianjuai.cc/v1"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好"}]
)
第三步：在知识库系统中配置调用
无论是自建的知识库问答系统，还是使用Dify、FastGPT、MaxKB等开源工具，你都可以在模型提供商设置中填入千聚的参数。通常步骤如下：
- 进入知识库系统的“模型接入”或“LLM配置”页面。
- 选择“OpenAI Compatible”或自定义API模式。
- 输入Base URL：
https://www.qianjuai.cc/v1 - 输入API Key：从千聚复制的密钥。
- 指定模型名称（例如
gpt-4o或gemini-2.0-flash）。 - 保存并执行一次测试问答，确认知识库能正常调用大模型。
通过千聚的中转能力，你可以在同一个接口下切换多种模型，而无需修改系统代码。这对于需要比较不同模型效果、或者为不同业务线选择最适合模型的团队来说，能显著降低接入复杂度。
第四步：排查常见问题
如果在调用过程中遇到错误，可以对照以下表格快速定位：
| 错误现象 | 可能原因 | 解决方法 |
|---|---|---|
| 401 Unauthorized | API Key错误或未生成 | 重新在千聚后台创建Key并复制到系统中 |
| 404 Model Not Found | 模型名称拼写有误或未开通 | 在千聚官网查看支持的模型列表 |
| 402 Payment Required | Token余额不足 | 购买Token后再次请求 |
| 速度较慢 | 所选模型或当前节点负载较高 | 可尝试更换同类模型（如从gpt-4o换为claude-3.5-sonnet） |
下一步行动
现在你已经掌握了知识库系统接入千聚AI中转站的核心流程。你的下一步可以是：
- 查看完整模型列表：访问千聚官网确认你需要的模型是否已支持。
- 补充Token：根据预估用量购买合适套餐，避免调用中断。
- 阅读更详细的API接入教程：了解流式传输、函数调用等高级用法。
- 开始正式接入：将上述配置部署到生产环境，为你的知识库用户提供智能问答体验。