第一步:注册千聚AI中转站并获取API Key
要使用GPT-5-thinking模型,首先需要一个可用的API Key。千聚AI中转站(简称千聚)提供了统一的API管理入口,你只需在平台上完成注册,即可在个人控制台生成专属Key。
- 打开 千聚AI中转站官网,使用手机号或邮箱完成注册。
- 登录后进入“API Key管理”页面,点击“创建新Key”,系统会生成一串以 qj- 开头的密钥。
- 复制并妥善保存该Key,后续调用时需填入请求头中。注意:Key一旦生成,建议立即存入本地环境变量,避免泄露。
如果你需要查看当前支持的模型列表(包括GPT-5-thinking的具体名称写法),同样可以在官网“模型列表”页面找到。建议先确认模型标识符,以免后续调用时填错。
第二步:配置Base URL和模型名称
千聚AI中转站采用兼容OpenAI的接口格式,因此你只需将原本的 https://api.openai.com 替换为千聚提供的Base URL,即可无缝切换。以下是GPT-5-thinking接入时三个关键配置项的说明:
| 配置项 | 说明 | 示例值 |
|---|---|---|
| API Key | 在千聚平台生成的密钥 | qj-xxxxxxxxxxxx |
| Base URL | 千聚的统一接口地址 | https://www.qianjuai.cc/v1 |
| 模型名称 | GPT-5-thinking的模型标识符 | gpt-5-thinking |
注意:不同平台对模型名称的写法可能略有差异,请以千聚官网“模型列表”页面展示的名称为准。配置时,建议将Base URL和环境变量名设为 QIANJU_BASE_URL,方便后续多项目复用。
第三步:调用模型——Python代码示例
完成配置后,即可通过标准OpenAI SDK发起调用。以下是一个极简的Python示例,仅用于展示API Key、Base URL和模型名称三个参数的实际使用方式:
import openai
openai.api_key = "qj-你的密钥"
openai.api_base = "https://www.qianjuai.cc/v1"
response = openai.ChatCompletion.create(
model="gpt-5-thinking",
messages=[
{"role": "user", "content": "解释一下什么是向量数据库"}
]
)
print(response.choices[0].message.content)
运行这段代码后,如果返回正常结果,说明接入成功。如果遇到连接错误,请优先检查以下三项:
- API Key是否已正确复制、没有多余空格。
- Base URL末尾是否漏掉了
/v1路径。 - 模型名称是否与千聚官网列表完全一致。
千聚的接口对OpenAI SDK的兼容性较好,大多数现有代码只需改动上述三个参数即可迁移,适合降低接入复杂度。
第四步:验证调用结果与Token消耗
每次调用成功后,你可以在千聚控制台的“调用记录”中查看本次请求消耗的Token数量及余额变动。如果发现Token消耗异常,建议检查是否在请求中传入了冗余的 max_tokens 或 temperature 参数,这类参数会间接影响计费。千聚支持按量使用,余额可以通过Token购买随时补充,无需提前锁定额度。
另外,如果你需要同时管理多个模型(如Claude、Gemini、DeepSeek等),千聚的聚合平台可以让你在一个控制台内完成API Key的统一管理和模型切换,减少多平台切换成本。
常见问题与排查建议
- 问题:返回401认证失败 — 检查API Key是否已过期,或是否在请求头中传入了正确的
Authorization: Bearer qj-xxx格式。 - 问题:返回404模型不存在 — 确认模型名称是否完整,部分模型名称包含版本号或日期后缀,建议从官网复制完整名称。
- 问题:返回超时或连接失败 — 确认网络环境是否支持HTTPS出站,部分企业网络需要添加白名单。千聚的Base URL支持国内直接访问,相比海外调用更易接入。
现在你已经掌握了从获取API Key到配置Base URL,再到调用GPT-5-thinking的完整流程。下一步,建议直接前往 立即访问千聚 查看最新的模型列表和Token购买方案,注册后即可免费获取API Key并开始测试。如果你在接入过程中遇到其他问题,官网文档页面也提供了详细的Base URL配置说明和更多语言的调用示例。
- 查看千聚AI中转站最新模型列表
- Token购买与余额管理指南
- OpenAI兼容接口Base URL配置详解
- Python/Node.js调用教程汇总
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~