一、注册千聚并获取 API Key
任何调用都需要一个合法的身份凭证。你只需在 千聚AI中转站官网 完成注册,进入控制台即可创建一个专属 API Key。千聚支持多模型聚合,同一个密钥可以调用 OpenAI、Claude、DeepSeek、Gemini、Grok、Qwen、Kimi 等主流模型,无需在多个平台重复申请。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,适合需要快速配置 Codex 令牌 API key 的用户。
- 注册后进入「API 密钥」页面生成 Key
- 复制并保管好密钥(后续不再明文显示)
- 可以在控制台随时查看额度或禁用密钥
二、配置 Base URL 和模型名称
千聚提供完全兼容 OpenAI 格式的接口,因此你只需将代码中的 base_url 指向千聚提供的地址,并将 model 参数换成对应的模型标识。具体地址和模型名称可在官网「模型列表」页面获取,无需额外修改 SDK。
# 典型配置示例(Python OpenAI 库)
openai.api_key = "sk-你的千聚APIKey"
openai.base_url = "https://api.token88.cc/v1/" # 千聚 Base URL
模型名例如 gpt-4o、claude-sonnet-4-20250514、deepseek-chat 等,以官网实时列表为准。这种统一调用的方式显著降低多模型接入的维护成本。
三、执行一次模型调用
以下是一个完整的 Python 对话示例,演示如何通过千聚接口发起请求:
from openai import OpenAI
client = OpenAI(
api_key="你的APIKey",
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)
如果返回正确结果,说明调用成功。你可以将同一段代码中的 model 替换为其他模型(如 claude-sonnet-4-20250514),即可体验不同模型的输出风格。整个过程无需改动密钥和基础地址,极大简化了多模型切换流程。
四、常见接入问题排查
实际操作中可能遇到一些小问题,以下为几种典型情况:
| 现象 | 可能原因 | 解决方式 |
|---|---|---|
| 401 认证失败 | API Key 填写错误或已过期 | 在控制台重新生成并复制 |
| 404 模型不存在 | 模型名称拼写错误或不在服务列表 | 核对官网最新模型标识 |
| 余额不足 | 账户 Token 用完 | 前往官网购买 Token 充值 |
如果问题依然存在,可查阅 立即访问千聚 的帮助文档或联系支持。
下一步操作: 现在你已掌握“模型中转站如何调用”的核心步骤。前往千聚官网查看完整模型列表、购买 Token 并获取你的专属 API Key,立刻开始测试多模型调用。