理解API Key、Base URL和模型名称
在调用任何AI模型之前，需要先明确三个核心配置：
- API Key：身份凭证，用于验证请求来源。千聚的API Key可在控制台内生成并管理，支持随时轮换和权限控制。
- Base URL：请求发送的目标地址。千聚采用兼容OpenAI的接口格式，Base URL统一为
https://www.qianjuai.cc/v1，无需为不同模型单独配置。 - 模型名称：指定要调用的具体模型，如
gpt-4o、claude-sonnet-4、deepseek-chat等。千聚聚合了数十款主流模型，名称列表可在官网实时查看。
理解这三者的关系后，代码示例就变得非常直观。
Python代码示例：在千聚上完成一次模型调用
以下示例使用OpenAI官方Python库，只需修改Base URL和API Key即可完成调用。注意，代码中仅展示三个配置点的变化，其他参数与标准OpenAI调用完全一致。
import openai
client = openai.OpenAI(
api_key="sk-你的千聚API 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)
执行后，你会收到模型返回的响应。如果需要切换模型，只需将 model 参数改为其他名称，例如 claude-sonnet-4 或 gemini-2.0-pro，无需修改其他代码。这正是千聚作为AI聚合平台的核心优势——降低接入复杂度，减少多平台切换成本。
如果你使用Node.js或curl，原理同样如此：替换Base URL和API Key即可。
如何快速获取这些配置
要运行上述代码，需要先获取有效的API Key和正确的Base URL。操作步骤如下：
- 访问 千聚AI中转站官网 并注册账号。
- 在控制台内生成一组API Key，并复制到剪贴板。
- 在“接口文档”中确认Base URL为
https://www.qianjuai.cc/v1，以及当前支持的模型名称列表。 - 购买适量Token，确保账户有余额供调用消耗。
整个过程只需几分钟，之后即可用上述代码示例进行测试。
调用失败的常见原因与排查
初次调用时可能遇到错误，以下是最常见的几种情况：
| 错误提示 | 可能原因 | 解决方式 |
|---|---|---|
| 401 Unauthorized | API Key无效或已过期 | 在控制台重新生成Key并更新 |
| 404 Not Found | 模型名称错误或不存在 | 核对官网模型列表中的正确名称 |
| 429 Too Many Requests | 请求频率过高或余额不足 | 降低调用频率或补充Token |
如果问题仍未解决，可以查看千聚的文档或联系客服。聚合平台的优势在于，你只需熟悉一套接口规范，就能应对多个模型，排查难度也相应降低。
相关资源
下一步行动
访问 立即访问千聚，注册账号并获取API Key，然后用本文中的代码示例完成你的第一次模型调用。从理解配置到实际运行，整个过程只需几分钟。