第一步：获取API Key与Base URL
在开始配置之前，你需要先准备好两个核心凭证：API Key 和 Base URL。千聚AI聚合平台为所有注册用户提供了统一的接口入口，无需为每个模型单独申请密钥。
- 访问 千聚AI中转站官网 完成注册并登录。
- 在控制台找到“API Key管理”页面，点击创建新密钥，系统会生成一串以
qj-开头的密钥。 - 在同一页面查看Base URL地址，通常格式为
https://www.qianjuai.cc/v1，这是所有模型调用的统一入口。
千聚的Base URL设计遵循OpenAI兼容接口规范，因此你之前使用OpenAI SDK的代码几乎可以无缝迁移，只需替换API Key和Base URL即可开始工作。
第二步：配置Base URL的三种方式
拿到Base URL和API Key后，下一步就是将它们写入代码。以下是三种最常见的配置方式，分别对应不同开发场景。
方式一：Python OpenAI SDK 配置
如果你使用Python的 openai 库，配置方式最直接：
from openai import OpenAI
client = OpenAI(
api_key="qj-你的密钥",
base_url="https://www.qianjuai.cc/v1"
)
将 base_url 参数设置为千聚的统一入口地址，即可调用平台上所有模型，包括GPT-5、Claude、Gemini、DeepSeek等。
方式二：环境变量配置
适合需要多项目复用或团队协作的场景：
export OPENAI_BASE_URL="https://www.qianjuai.cc/v1"
export OPENAI_API_KEY="qj-你的密钥"
设置为环境变量后，整个系统的AI请求都会自动走千聚线路，无需重复写参数。
方式三：Node.js 的 axios 请求
如果你习惯直接调用HTTP接口，也可以这样写：
const response = await axios.post('https://www.qianjuai.cc/v1chat/completions', {
model: 'gpt-4o',
messages: [{role: 'user', content: '你好'}]
}, {
headers: { 'Authorization': 'Bearer qj-你的密钥' }
})
注意Base URL后面要拼接具体的接口路径，如 /chat/completions，这是OpenAI兼容接口的标准格式。
第三步：模型调用测试
配置完成后，建议先跑一次简单的测试，验证整个链路是否连通。以Python为例，调用千聚平台上的一个主流模型：
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "请用一句话介绍千聚AI聚合平台"}]
)
print(response.choices[0].message.content)
如果返回正常结果，说明你的Base URL和API Key配置正确，API Key账户余额充足，模型名称也未写错。如果遇到报错，请对照下表快速排查。
| 错误信息 | 常见原因 | 解决方法 |
|---|---|---|
| 401 Unauthorized | API Key错误或已过期 | 重新生成密钥并替换 |
| 404 Not Found | Base URL或模型名错误 | 检查地址末尾是否遗漏 /v1 |
| 429 Too Many Requests | 额度不足或频率超限 | 前往千聚平台购买Token |
| 503 Service Unavailable | 临时服务波动 | 稍后重试或切换备用模型 |
统一接口的优势
使用千聚这类AI聚合平台最大的好处是：一次配置，多模型可用。你不需要为OpenAI、Claude、Gemini、DeepSeek分别维护不同的Base URL和API Key，所有调用都走同一个入口，切换模型时只需修改 model 参数。这种架构尤其适合需要快速搭建原型、降低接入复杂度的团队，也可以作为主力线路的备用方案，提升整体可用性。
立即开始你的第一次调用
以上就是从获取凭证到完成模型调用的完整流程。配置Base URL只需要三步：注册账号、获取密钥、填入代码。如果你还没有千聚账户，不妨花两分钟注册，体验一次统一接入的便捷。
立即访问 千聚AI中转站官网 创建你的API Key，并查看平台上支持的全部模型列表。购买Token后即可开始调用，按量计费，用多少充多少，没有固定套餐压力。
- 千聚AI聚合平台Base URL配置常见问题汇总
- 从零开始接入千聚：API Key与模型调用实战
- 千聚Token购买与Base URL配置全流程解读