
一、注册账号并获取API Key
要开始使用中转站,首先需要拥有一个账号。访问千聚AI中转站官网完成注册后,进入控制台找到“API Key管理”页面。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,适合需要快速配置 Codex 令牌 API key 的用户。
- 登录千聚平台,在左侧菜单选择“API Keys”。
- 点击“创建新密钥”,系统会生成一串以
qj-开头的密钥。 - 复制并保存好该密钥,后续所有调用请求都需要携带它。
注意:请勿将API Key泄露到客户端代码或公开仓库中。如果不慎泄露,可在同一页面撤销并重新生成。
二、配置Base URL与模型名称
SaaS接入模型中转站的关键在于统一Base URL。大多数主流中转站都兼容OpenAI接口格式,因此你只需更换默认的api.openai.com为中转站提供的地址。
千聚AI中转站的标准Base URL为:https://api.token88.cc/v1。模型名称则使用中转站定义的名称映射,例如gpt-4o、claude-3-opus-20240229、gemini-2.0-flash等。具体支持哪些模型,请参阅千聚AI中转站官网上的模型列表页面。
| 配置项 | 官方OpenAI | 千聚中转站 |
|---|---|---|
| Base URL | https://api.openai.com/v1 | https://api.token88.cc/v1 |
| API Key | sk-开头的密钥 | qj-开头的密钥 |
| 模型名 | gpt-4o | gpt-4o(保持一致) |
三、Python代码调用示例
以下是一个简单的调用示例,演示如何用配置好的信息请求模型回复。仅需修改API Key和Base URL即可直接运行。
import openai
openai.api_key = "你的千聚API Key"
openai.base_url = "https://api.token88.cc/v1/"
response = openai.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好,请用一句话介绍自己。"}]
)
print(response.choices[0].message.content)
如果你使用Node.js或curl,修改方式完全一致,只需调整baseURL参数。完成测试后,可以在控制台查看Token消耗情况。
四、常见配置注意事项
- API Key格式:请确保复制的是完整密钥,不含多余空格。
- Base URL末尾斜杠:部分SDK要求base_url以
/v1结尾,部分需要/v1/,请根据实际报错调整。 - 模型名称大小写:中转站对模型名严格区分大小写,例如
claude-3-opus-20240229不能写成Claude-3-Opus。 - Token余额:调用前请确保账户有足够余额。可前往官网购买Token包,支持按量充值,用多少扣多少。
立即开始调用模型
访问立即访问千聚,注册后获取API Key,选择你需要的模型,最快5分钟完成接入。