第一步：注册千聚并获取API Key
要使用千聚AI中转站的聚合接口，首先需要注册账号并生成一组API Key。访问千聚AI中转站官网，完成注册后进入控制台，在“API Key管理”页面可以创建新的Key。创建时建议为每个项目或环境单独生成Key，便于后续管理和权限控制。生成的Key是一个字符串，例如 sk-qianju-xxxxxxxx，请妥善保存，后续Python调用时会用到。
第二步：配置Base URL——千聚的统一接入点
千聚AI中转站提供了与OpenAI完全兼容的接口地址，这意味着你只需将原本指向OpenAI的Base URL替换成千聚的地址，即可使用同一套代码调用多个模型。千聚的Base URL通常为：https://www.qianjuai.cc/v1（具体以官网最新文档为准）。在Python代码中，如果你使用OpenAI官方库，只需设置 openai.api_base = "https://www.qianjuai.cc/v1" 或通过客户端参数传入。这样所有请求都会经过千聚的聚合层，无需再为每个模型单独配置不同的接入点。
第三步：模型切换——通过参数灵活选择
千聚支持大量主流模型，包括GPT-4系列、Claude、Gemini、DeepSeek、Qwen、Kimi、豆包、GLM等。在调用时，只需在请求中指定 model 参数即可切换模型。例如，要使用GPT-4o，设置 model="gpt-4o"；要使用Claude，设置 model="claude-3-5-sonnet"。具体模型名称列表请参考千聚官网的模型文档。这种统一接口的设计让你在切换模型时只需改一行代码，大大降低了多模型调用的维护成本。
第四步：Python调用示例——三行代码跑通
下面是一个完整的Python调用示例，使用OpenAI库，展示如何配置API Key、Base URL和模型名称：
import openai
openai.api_key = "sk-qianju-xxxxxxxx" # 替换为你的API Key
openai.api_base = "https://www.qianjuai.cc/v1" # 千聚Base URL
response = openai.ChatCompletion.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好，请介绍一下自己。"}]
)
print(response.choices[0].message.content)
将以上代码保存为 test.py，安装好 openai 库（pip install openai）后运行，即可看到模型返回结果。如果使用其他库（如revChatGPT、requests），原理类似，只需替换相应的URL和Key参数。
常见问题与排查建议
- 认证失败（401）：检查API Key是否复制完整，注意不要遗漏前缀或空格。
- 模型不存在（404）：确认模型名称是否与千聚文档中的名称一致，部分模型可能带有版本号。
- 连接超时：检查网络是否能够访问千聚的Base URL，部分企业内网可能需要配置代理。
- 余额不足：调用前请确保账户中有足够的Token余额，可前往千聚官网购买Token。
如果以上问题仍未解决，建议直接访问立即访问千聚查看最新的API文档或联系技术支持。
下一步：开始你的第一次Python调用
现在你已经掌握了千聚AI聚合平台Python调用的核心配置：Key、URL和模型名称。接下来要做的就是打开编辑器，填入你自己的API Key，运行上面的示例代码，验证一次完整的调用链路。如果一切正常，你就可以在此基础上扩展更多功能，比如流式输出、多轮对话或批量调用。
如果需要查看所有支持的模型列表、了解Token价格或购买更多额度，请直接访问千聚官网操作。以下是一些常用入口，供你参考：