第一步:注册并获取API Key
使用任何模型中转站,第一步都是获取有效的API Key。千聚AI中转站提供统一的密钥管理后台,注册后即可在个人控制台创建Key,支持按项目或环境分别管理权限。具体步骤如下:
- 访问 千聚AI中转站官网 完成账号注册(邮箱或手机均可)。
- 登录后在“API Key”页面点击“创建新密钥”,建议备注用途(如“开发测试”“线上生产”)。
- 复制生成的Key,妥善保存;后续调用时直接将其填入
Authorization请求头。
如果你已经拥有其他平台的API Key,千聚完全兼容OpenAI接口格式,无需额外适配。
第二步:配置Base URL和模型名称
千聚的Base URL固定为你账户分配的入口地址(通常在控制台可见),模型名称则统一采用社区通用名。例如调用OpenAI的GPT-4o,只需将 model 设为 gpt-4o,将 base_url 设为千聚的转发地址即可。下面用Python示例展示三个配置点的使用方法:
import openai
openai.api_key = "sk-你的千聚API Key"
openai.base_url = "https://api.token88.cc/v1" # 实际地址以控制台为准
model_name = "gpt-4o"
这样配置后,你就能像调用官方API一样使用千聚聚合的所有模型,包括Claude、Gemini、DeepSeek、Qwen等。如果需要切换模型,只需修改 model_name 字符串。
第三步:发送首次请求并检查响应
为了验证配置是否正确,建议先发一个简单的聊天补全请求。以下代码会返回助手的回复,如果收到错误码,可以根据类型快速排查:
| 错误码 | 常见原因 | 解决方法 |
|---|---|---|
| 401 | API Key无效或过期 | 重新生成Key并检查环境变量 |
| 404 | 模型名称不匹配 | 对照官网模型列表修正名称 |
| 429 | 请求频率超限或余额不足 | 购买更多Token或降低并发 |
| 500 | 服务临时异常 | 稍后重试或切换备用节点 |
千聚的控制台实时显示每次调用的Token消耗和余额变动,方便做成本追踪。这也是许多团队将其作为主力中转站的原因——千聚提供的统一管理界面比分散维护多个平台更有效率。
第四步:按需扩展与持续集成
当你确认单次调用成功后,就可以将配置嵌入业务代码或自动化工作流。比如使用千聚的批量API实现多模型对比,或者作为备用路由在某个模型限流时自动降级。所有模型共享同一个Base URL和密钥体系,切换零成本。
如果遇到任何接入问题,官网文档提供了详细的常见错误码说明和示例代码。现在就去获取你的API Key,打开编辑器试试吧——
立即开始使用千聚AI中转站:
访问官网注册并购买Token,查看完整模型列表和API接入教程。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~