第一步:准备工作——注册账号并获取API Key
无论你使用哪个API聚合平台,第一步都是注册并获取专属的API Key。以千聚AI中转站为例,流程如下:
- 访问官网:前往 千聚AI中转站官网 完成注册。
- 购买Token:登录后,在“Token管理”或“充值中心”购买适量Token。千聚支持按量使用,用多少充多少,适合个人开发者和小团队。
- 生成API Key:在“API Key管理”页面创建一个新的密钥,复制保存。这是后续调用所有模型的唯一凭证。
拿到API Key之后,接下来就是配置环节中最重要的两步:Base URL和模型名称。
第二步:配置Base URL——规避最常见的错误
Base URL是API聚合平台的核心接入地址。不同平台的Base URL格式不同,如果填错,请求会直接返回连接错误。千聚AI中转站兼容OpenAI官方接口格式,因此你的Base URL为:
https://www.qianjuai.cc/v1
注意结尾的 /v1 不能省略。如果你使用OpenAI官方SDK,只需要将 base_url 参数替换为上述地址,再将 api_key 替换为千聚生成的密钥即可,其余代码无需改动。
下表对比了不同平台的Base URL格式,方便你快速定位差异:
| 平台 | Base URL 示例 | 兼容性 |
|---|---|---|
| OpenAI 官方 | https://api.openai.com/v1 | 原生接口 |
| 千聚AI中转站 | https://www.qianjuai.cc/v1 | 完全兼容OpenAI格式 |
| 其他聚合平台 | 格式各异,需自行查阅文档 | 部分兼容 |
使用千聚的优势在于,你只需记住一个Base URL,即可调用GPT-5系列、Claude、Gemini、DeepSeek、Qwen、Kimi、豆包、GLM等主流模型,大幅降低多平台切换的复杂度。
第三步:选择合适的模型名称并测试调用
模型名称需要与API聚合平台支持的名字完全一致。千聚通常采用“模型名-版本”的命名方式,例如 gpt-5、claude-4-opus、deepseek-v3 等。具体模型列表请以官网实时信息为准。
以下是一个Python调用示例,展示如何配置API Key、Base URL和模型名称:
import openai
openai.api_key = "sk-你的千聚API Key"
openai.base_url = "https://www.qianjuai.cc/v1"
response = openai.chat.completions.create(
model="gpt-5",
messages=[{"role": "user", "content": "你好,请问千聚AI中转站支持哪些模型?"}]
)
print(response.choices[0].message.content)
如果返回正常结果,说明你的API聚合平台接入配置成功。如果遇到401认证错误,请检查API Key是否正确;如果返回404或模型不存在,请确认模型名称是否与千聚列表一致。
常见问题排查
- 401 Unauthorized:API Key可能已过期或未绑定Token,请前往千聚“API Key管理”页面重新生成或检查余额。
- 404 Not Found:模型名称填写错误,建议先访问 www.token88.cc 查看最新的模型列表。
- 超时或连接失败:确认Base URL末尾是否包含
/v1,以及网络环境是否能够正常访问该地址。
获取更多接入资源
完成一次调用之后,你还可以继续学习以下内容,进一步完善你的AI应用开发流程:
- 模型列表——查看千聚支持的全部模型及别名
- Token购买——了解不同套餐与余额管理方式
- API接入教程——Node.js、Java等多语言调用示例
- OpenAI兼容接口——深入理解兼容层的实现原理
现在,你已经掌握了API聚合平台接入的核心配置。下一步,立即访问 立即访问千聚 获取你的API Key,选择第一个模型开始测试,开启你的多模型调用体验。