
第一步:注册账号并获取API Key
开始配置前,你需要一个有效的账号和对应的API Key。API Key是后续所有调用请求的身份凭证,其安全性和可用性直接影响到你的开发效率。
完成账号注册后,系统会生成一个专属的API Key。建议你将Key保存在安全的位置,不要在代码中硬编码,可以使用环境变量或配置文件来管理。如果你还没有账号,可以访问 千聚AI中转站官网 完成注册并获取你的第一个API Key。
第二步:确定Base URL与模型名称
大模型中转站配置的核心在于三个字段:Base URL、API Key和Model Name。其中Base URL决定了请求发往的网关地址,而模型名称则决定你实际调用的是哪个大模型。
以千聚为例,其Base URL格式通常为:
https://api.token88.cc/v1
获取准确的Base URL后,你还需要确认支持哪些模型名称。常见模型如gpt-4、claude-3、deepseek-chat、gemini-pro等,具体列表建议直接查看官方文档。
配置要点一览
| 配置项 | 说明 | 注意事项 |
|---|---|---|
| API Key | 身份认证令牌 | 请勿泄露,建议使用环境变量 |
| Base URL | API网关地址 | 确认末尾是否包含/v1 |
| Model Name | 目标模型标识 | 大小写需与官方一致 |
第三步:配置OpenAI兼容客户端进行调用
大多数大模型中转站(包括千聚)兼容OpenAI的接口格式,因此你可以直接使用现有的OpenAI SDK或库进行调用,只需修改Base URL和API Key即可。
以下是一个简单的Python示例:
from openai import OpenAI
client = OpenAI(
api_key="your-api-key-here",
base_url="https://api.token88.cc/v1"
)
response = client.chat.completions.create(
model="gpt-4",
messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)
如果你使用不同模型,只需替换model参数和对应的Base URL即可。千聚支持多种主流模型,配置方式完全一致,适合降低接入复杂度。
第四步:测试调用和排查常见问题
完成配置后,建议先发送一条简单请求进行测试。如果遇到错误,可按以下顺序排查:
- 401错误:检查API Key是否填写正确,是否有过期。
- 404错误:检查Base URL路径是否完整,模型名称是否支持。
- 429错误:请求频率过高,需降低调用频率或查看Token余额。
- 超时错误:网络不稳定或代理配置有问题,尝试更换网络环境。
如果问题仍然存在,可以查阅官方文档或联系技术支持。
第五步:管理Token余额和模型切换
完成首次调用后,你可能需要关注Token消耗情况和余额管理。千聚支持按量使用,你可以在后台实时查看Token使用明细、剩余额度,并随时切换不同模型。
对于团队用户,建议为不同项目或成员分配独立的API Key,便于统一管理和控制消耗。你可以在 立即访问千聚 查看完整的模型列表和Token购买方案。
下一步行动
访问千聚官网,查看最新模型支持列表、获取你的专属API Key,并开始你的第一次模型调用测试。详细的Python、Node.js调用教程也可以在文档中找到。
- 查看完整模型列表
- 购买Token并查看余额
- 获取API Key接入指南
- 阅读OpenAI兼容接口文档
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~