第一步：注册账号并获取API Key
在开始接入之前，需要先拥有一个可用的中转站账号。访问 千聚AI中转站官网 完成注册，登录后进入控制台，在“API Key管理”页面创建新的密钥。建议为知识库系统单独生成一个Key，便于后续按项目进行用量统计和权限管理。
获取API Key后，将其妥善保存。该Key是调用所有模型的凭证，后续配置Base URL和发起请求时都会用到。
第二步：配置Base URL与模型名称
千聚AI中转站采用与OpenAI完全兼容的接口规范，因此知识库系统只需修改两处配置即可完成对接：Base URL和模型名称。具体配置方式如下：
- Base URL：将原有OpenAI的地址
https://api.openai.com替换为千聚提供的统一接入地址。该地址在控制台首页和文档中均可查看，通常格式为https://api.token88.cc/v1。 - 模型名称：根据知识库需要选用的模型，填写对应的模型标识。例如，若希望使用GPT-4o系列处理问答任务，模型名称为
gpt-4o；若需调用Claude或DeepSeek，则填写对应模型的千聚命名（如claude-3-5-sonnet、deepseek-chat）。完整模型列表请参考官网文档。
配置完成后，知识库系统的API调用请求会自动路由到千聚集群，无需逐一对接各个模型厂商，可有效降低接入复杂度。
第三步：使用Python进行模型调用测试
以下是一段简单的Python代码示例，演示如何用配置好的API Key和Base URL发起一次模型调用，验证知识库系统能否正常通信：
from openai import OpenAI
client = OpenAI(
api_key="你的API Key",
base_url="https://api.token88.cc/v1"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "user", "content": "请根据知识库中的资料回答：什么是千聚AI中转站？"}
]
)
print(response.choices[0].message.content)
如果返回了正确的回答内容，说明知识库系统已成功接入模型中转站。如果出现错误，请检查API Key是否正确、Base URL是否完整、模型名称是否在可用列表中，以及账户余额是否充足。
常见问题排查
| 问题现象 | 可能原因 | 解决建议 |
|---|---|---|
| 401 Unauthorized | API Key无效或已过期 | 重新生成Key并更新配置 |
| 404 Not Found | 模型名称填写错误 | 对照官网文档核对模型标识 |
| 返回空结果或超时 | 账户余额不足 | 及时购买Token补充余额 |
对于更复杂的业务场景，如多轮对话、流式输出或文件上传，千聚同样支持OpenAI原生接口的全部参数，知识库系统可直接复用现有代码逻辑，迁移成本极低。
为什么选择千聚作为知识库系统的中转站
千聚AI中转站聚合了包括GPT-5系列、Claude、Gemini、DeepSeek、Qwen、Kimi、豆包、GLM等在内的多种主流模型，开发者只需管理一套API Key和Base URL，即可按需切换模型。对于知识库系统而言，这种统一接入方式既能快速响应不同场景的模型需求，也便于进行Token用量和成本控制。此外，千聚支持按量购买Token，余额实时可见，更适合预算敏感或需要灵活调配资源的团队。
下一步：开始你的第一次调用
知识库系统的接入并不复杂，核心在于准备好API Key、正确配置Base URL并选择合适的模型。如果你已经完成了上述步骤，不妨立即进行一次测试调用，验证整个链路是否通畅。如需查看完整的模型列表、获取最新的接入地址或购买Token，请访问 立即访问千聚 查看实时信息。
- 查看完整模型列表
- Token购买与余额管理
- API接入教程与调试工具
- OpenAI兼容接口文档