
第一步:注册千聚账号并获取API Key
任何SaaS接入模型中转站的起点都是创建账号。访问千聚AI中转站官网,完成邮箱或手机号注册。登录后进入用户控制台,你会看到“API Key管理”页面。点击“创建新密钥”,系统会生成一串以sk-开头的密钥。请立即复制并妥善保存,因为页面关闭后密钥不再完整显示。这一步的要点:每个API Key可以单独设置权限和额度,适合团队按成员分配。如果需要测试,平台通常提供小额免费体验额度,建议先验证基础连通性。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,适合需要快速配置 Codex 令牌 API key 的用户。
第二步:配置Base URL与模型名称
拿到API Key之后,下一步是配置Base URL。千聚AI中转站兼容OpenAI接口格式,只需将原来调用OpenAI的地址替换为千聚提供的统一网关:
Base URL: https://api.token88.cc/v1
模型名称则需要根据你想要的模型填写。例如调用GPT-4o系列可以使用gpt-4o,调用Claude 3.5 Sonnet可以使用claude-3-5-sonnet。完整的模型列表可以在官网“模型广场”中实时查看,支持OpenAI、Claude、Gemini、DeepSeek、Grok、Qwen、Kimi、豆包、GLM等数十个方向。配置时只需修改model字段,无需切换不同的API地址,这就是SaaS接入模型中转站的核心便利——统一入口,多模型切换。
第三步:使用Python发起第一次调用
以下是一个简洁的Python调用示例,使用OpenAI官方库(需提前安装openai):
from openai import OpenAI
client = OpenAI(
api_key="你的千聚API Key",
base_url="https://api.token88.cc/v1"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "请用中文说你好"}]
)
print(response.choices[0].message.content)
将上述代码中的api_key替换为你在第一步获取的密钥,执行后即可收到模型回复。如果遇到连接超时或认证错误,常见原因包括:API Key未复制完整、Base URL末尾缺少/v1、或者所选模型名称与平台公布的不一致。建议先调用一个简单模型(如gpt-3.5-turbo)来排查基础连通性。SaaS接入模型中转站的好处在于,一旦配置成功,后续如需切换模型只需更改model参数,代码无需大改。
常见问题与排查建议
| 问题现象 | 可能原因 | 解决方向 |
|---|---|---|
| 401 Unauthorized | API Key无效或过期 | 返回控制台重新生成密钥 |
| 404 Not Found | 模型名称错误 | 查看官网模型列表确认名称 |
| 超时 | 网络或代理问题 | 检查是否能访问api.token88.cc |
| 余额不足 | Token额度耗尽 | 前往官网充值Token |
对于团队使用场景,千聚支持子账户管理,可以为主账户创建多个子API Key并分配额度,方便追踪每个项目的消耗。这也是SaaS接入模型中转站更适用于企业级用户的优势之一。
直接开始测试
现在你已经掌握了SaaS接入模型中转站怎么接入的完整三步流程。下一步最实际的动作就是亲自跑一遍示例代码。如果还没有API Key,请立即访问www.token88.cc注册并获取密钥。官网首页提供实时模型列表、Token购买入口以及详细的API文档,帮助你快速上手。
相关资源: