
注册账号并创建API Key
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,适合需要快速配置 Codex 令牌 API key 的用户。
使用中转站的第一步是获取有效的API Key。以千聚AI中转站为例,访问千聚AI中转站官网,使用邮箱完成注册。登录后进入“API管理”页面,点击“创建API Key”,系统会生成一串密钥字符串。请将Key复制保存到本地,页面关闭后不可再次查看原始值,建议启动时写入环境变量而非硬编码。
千聚的API Key管理还支持多Key轮换、自定义备注和权限分组,方便团队协作。如果你需要分发Key给不同项目,可以随时创建多个Key并单独禁用。
正确配置Base URL
中转站的核心价值在于提供一个统一的基础访问地址,你无需再为每个模型维护不同的端点。千聚AI中转站采用OpenAI兼容接口格式,其Base URL为https://api.token88.cc/v1(具体地址请以控制台显示为准)。配置时,根据你所使用的库进行设置:
- Python openai 库:通过
openai.base_url = "https://api.token88.cc/v1/"指定(注意结尾斜杠)。 - Node.js openai 库:构造
new OpenAI({ baseURL: "https://api.token88.cc/v1/" })。 - 直接HTTP请求:将URL前缀指向
https://api.token88.cc/v1/chat/completions等具体路径。
如果不确定地址,可以登录千聚控制台,在“接口信息”页面直接复制Base URL。务必确认使用HTTPS,避免中间人攻击。
选择正确的模型名称
模型名称是每次调用时必须传入的参数。千聚AI中转站聚合了多个主流模型系列,例如gpt-4、claude-3-opus、gemini-pro、deepseek-chat等。具体的可用模型列表会动态更新,建议通过千聚AI中转站官网的“模型列表”页查看最新支持情况。部分模型可能有别名或版本后缀,使用时以控制台给出的精确字符串为准。
你也可以通过调用GET /v1/models接口在程序中动态获取模型清单,便于自动选择或限选。
测试一次模型调用
以下提供两个常见语言的调用示例,均使用千聚的Base URL和API Key。请替换其中的密钥字符串和模型名为实际值。
Python(使用openai库)
import openai
openai.api_key = "sk-your-key-here"
openai.base_url = "https://api.token88.cc/v1/"
response = openai.ChatCompletion.create(
model="gpt-4",
messages=[{"role": "user", "content": "请用中文回答,你好"}]
)
print(response["choices"][0]["message"]["content"])
Node.js(使用openai库)
import OpenAI from "openai";
const openai = new OpenAI({
apiKey: "sk-your-key-here",
baseURL: "https://api.token88.cc/v1/"
});
const response = await openai.chat.completions.create({
model: "claude-3-opus",
messages: [{ role: "user", content: "你好" }]
});
console.log(response.choices[0].message.content);
如果你用curl测试,命令类似:
curl https://api.token88.cc/v1/chat/completions
-H "Authorization: Bearer sk-your-key-here"
-H "Content-Type: application/json"
-d '{"model":"gpt-4","messages":[{"role":"user","content":"Hello"}]}'
成功返回后即可确认配置正确。
常见问题与Token管理
调用中可能遇到的状态码及典型原因:
| 状态码 | 常见原因 | 建议排查 |
|---|---|---|
| 401 | API Key错误或已禁用 | 检查Key是否复制完整,或到控制台重新创建 |
| 404 | Base URL或模型名不正确 | 确认地址路径和模型字符串与官网一致 |
| 429 / 402 | 余额不足或触发速率限制 | 到千聚控制台购买Token或调整调用频率 |
千聚提供实时余额和用量图表,方便你掌控消耗。当余额接近阈值时可及时充值,避免服务中断。对于高频场景,还可以设置每日/每小时用量预警。
准备开始调用?立即访问 千聚AI中转站官网 注册账号、获取API Key、查看完整模型列表,并购买Token开始你的第一次调用。