第一步：注册千聚并获取API Key
任何API调用的前提都是拥有一组有效的API Key。在千聚AI中转站完成注册后，进入控制台的“API Key管理”页面，即可生成专属密钥。需要注意的是，API Key是调用费用的凭证，请妥善保管，不要直接暴露在客户端代码中。
注册流程非常简洁，填写邮箱并设置密码即可完成。之后登录 千聚AI中转站官网，在个人中心找到“我的API Key”模块，点击“创建新密钥”，系统会生成一串以“qj_”开头的字符串。复制并保存到安全位置，后续配置时直接粘贴即可。
第二步：配置Base URL和模型名称
客服系统调用大模型时，通常需要指定三个核心参数：API Key、Base URL和模型名称。很多开发者只填了Key，却忽略了Base URL，导致连接失败。
千聚的Base URL统一为：https://www.qianjuai.cc/v1。这个地址兼容OpenAI的接口格式，因此你的客服系统如果原本支持OpenAI，只需修改这一处地址即可完成切换。至于模型名称，千聚支持GPT-5系列、Claude、Gemini、DeepSeek、Qwen、Kimi、豆包、GLM等主流模型，具体名称列表可在官网查看。例如，使用DeepSeek-V3时，模型名填写“deepseek-chat”即可。
配置示例（Python环境）：
import openai
openai.api_key = "你的API_Key"
openai.base_url = "https://www.qianjuai.cc/v1"
model_name = "gpt-4o"
注意：Base URL的末尾是否需要“/”取决于你的SDK版本，建议统一加上“/v1/”以保证兼容性。如果遇到连接超时，先检查Base URL是否拼写错误。
第三步：编写调用代码并测试
完成配置后，即可通过简单的代码向客服系统发送第一条消息。以下是一个基于OpenAI Python SDK的完整调用示例，适用于任意兼容OpenAI的聚合平台：
import openai
openai.api_key = "你的API_Key"
openai.base_url = "https://www.qianjuai.cc/v1"
response = openai.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "system", "content": "你是一个智能客服助手。"},
{"role": "user", "content": "请介绍一下你们的退款政策。"}
]
)
print(response.choices[0].message.content)
如果返回正常，说明客服系统已成功接入大模型聚合平台。如果遇到错误，请看下方排查表。
常见问题排查
| 错误现象 | 可能原因 | 解决方法 |
|---|---|---|
| 401 Unauthorized | API Key 无效或已过期 | 重新生成Key并替换 |
| 404 Not Found | Base URL 或模型名错误 | 核对官网最新Base URL和模型名 |
| 429 Too Many Requests | 余额不足或并发超限 | 购买Token或降低请求频率 |
| 连接超时 | 网络环境或Base URL格式问题 | 检查代理设置，确认Base URL末尾格式 |
下一步：开始正式接入
完成以上步骤，你的客服系统已经具备了调用大模型的能力。但实际生产中，还需要考虑Token消耗、模型切换、错误重试等细节。千聚AI中转站提供了统一的余额管理和模型切换后台，适合国内团队降低多平台接入的复杂度。
现在就可以登录 立即访问千聚，查看完整模型列表，购买Token，并获取你的专属API Key，开始正式接入。