第一步：获取千聚API Key
访问千聚AI中转站官网注册账号，登录后在「API Key管理」页面创建新Key。千聚的Key采用标准格式，与OpenAI的sk-开头兼容，方便直接替换。创建后妥善保存，建议在代码中通过环境变量读取，避免硬编码泄漏。
第二步：确定Base URL
千聚的网关地址为：https://www.qianjuai.cc/v1（示例）。在Python调用中，将openai库的base_url参数设为该地址。注意不要遗漏末尾的/v1路径，这是OpenAI兼容接口的固定前缀。
- 常见错误：写成了
https://api.token88.cc（缺/v1）或加上了其他后缀。 - 千聚的Base URL可以在官网「开发文档-接入指南」中实时查看，确保使用最新地址。
第三步：Python调用示例
以下代码演示如何使用千聚网关调用GPT-4o模型（模型名需与千聚支持的名称一致）：
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("QIANJU_API_KEY"), # 替换为你的Key
base_url="https://www.qianjuai.cc/v1"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好，介绍一下千聚AI中转站。"}]
)
print(response.choices[0].message.content)
关键点：
- api_key：使用千聚生成的Key，注意不要带多余空格。
- base_url：必须设置为千聚的网关地址。
- model：根据千聚官网模型列表填写，例如
claude-3-opus、gpt-5、deepseek-chat等。
运行代码前，建议先在千聚后台购买Token并充值，确保账户有足够余额。Token购买入口在官网「Token管理」页，支持按量充值，用多少扣多少，适合开发者灵活控制成本。
常见配置错误排查
| 错误现象 | 可能原因 | 解决方法 |
|---|---|---|
| 401 Unauthorized | API Key错误或过期 | 重新生成Key，检查环境变量 |
| 404 Not Found | Base URL路径错误 | 确认是否包含/v1 |
| 模型不存在 | 模型名拼写不一致 | 对照千聚官网模型列表 |
| 余额不足 | Token用尽 | 访问官网购买Token |
千聚作为AI聚合平台，支持一键切换模型，无需更改代码结构，只需修改model参数即可。这种统一接入方式特别适合需要同时测试多模型的团队，降低后端维护复杂度。
开始你的第一次调用
配置好API Key和Base URL后，运行上面的Python代码，你应该能快速得到模型回复。如果遇到问题，可前往立即访问千聚查看详细的API接入教程和示例代码。千聚还提供了Node.js、curl等其他语言的调用示例，方便不同技术栈的开发者。
现在就去千聚官网注册账号、获取API Key并购买Token，体验一次完整的AI网关Python调用流程吧。使用千聚，你不再需要为每个模型单独申请Key和记不同地址，一个账户、一个Base URL就能调用主流大模型，真正实现“一次接入，多模型可用”。