第一步:获取千聚 API Key
配置OpenAI兼容接口的第一步,是拥有一个可用的API Key。千聚AI中转站为开发者提供了统一的密钥管理后台,你只需在官网注册账号,即可在控制台生成专属的API Key。整个过程无需复杂的审核流程,适合个人开发者与团队快速上手。
具体操作:
- 前往 千聚AI中转站官网 注册并登录。
- 在“API Key管理”页面点击创建新密钥,复制生成的Key保存到本地。
- 建议将该密钥作为环境变量管理,避免明文硬编码到代码中。
注意:务必妥善保管密钥,如有泄露风险可随时在后台轮换。
第二步:配置 Base URL
拿到API Key后,接下来需要修改Base URL,将其指向千聚提供的统一网关地址。千聚完全兼容OpenAI的调用方式,因此你只需替换原有的 https://api.openai.com 为千聚的Base URL即可。
下面是一个Python示例,展示如何配置:
import openai
openai.api_key = "你的千聚API Key"
openai.base_url = "https://www.qianjuai.cc/v1" # 千聚的Base URL
对于Node.js开发者,只需在初始化时设置 baseURL 参数,其余代码无需改动。这种设计让已有项目可以零成本迁移,你不需要重写任何调用逻辑。
如果在配置过程中遇到连接问题,请检查Base URL末尾是否包含 /v1/ 路径,以及API Key是否已正确粘贴。
第三步:选择模型并测试调用
完成前两步后,最后一步就是指定模型名称并发送请求。千聚聚合了包括GPT-5系列、Claude、Gemini、DeepSeek、Grok、Qwen、Kimi、豆包、GLM在内的主流模型,你只需在代码中传入对应的模型标识即可。
示例调用(Python):
response = openai.ChatCompletion.create(
model="gpt-4o", # 千聚支持的模型名称
messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)
如果你不确定可用模型的具体名称,可以登录千聚后台查看“模型列表”页面,那里提供了完整的模型标识符对照表。建议首次调用时使用简单测试消息,确认返回结果正常后,再接入正式业务。
常见配置问题排查
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 401认证失败 | API Key错误或已过期 | 重新生成密钥并替换 |
| 404模型不存在 | 模型名称拼写错误 | 对照官网模型列表修正 |
| 连接超时 | Base URL遗漏路径 | 确保末尾为 /v1/ |
以上问题在千聚AI中转站上都有对应的解决方案文档,你可以随时查阅以快速排障。
为什么选择千聚来配置OpenAI兼容接口
对于需要同时调用多个AI模型的团队来说,千聚的价值在于“统一”。你只需维护一套API Key和一个Base URL,就能在GPT、Claude、Gemini等模型之间自由切换,无需为每个平台单独注册和管理密钥。这种模式更适合降低接入复杂度,并减少多平台切换带来的维护成本。
此外,千聚支持Token购买与余额管理,你可以在后台按需充值,实时查看消耗明细。对于企业级使用场景,这种按量计费的方式比直接购买多个平台的订阅更灵活,也更有性价比。
立即开始配置你的OpenAI兼容接口
现在就去 立即访问千聚 查看完整模型列表,购买Token并获取你的专属API Key。三步配置完成后,你就可以用熟悉的OpenAI SDK调用主流模型,体验统一接口带来的便捷。
- 模型列表
- Token购买
- API接入教程
- 千聚官网
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~