第一步:确认账户与API Key获取方式
在开始配置之前,请确保你已在千聚AI中转站完成注册并登录。平台支持个人开发者与企业团队两种类型,注册流程简单,无需额外审核。完成注册后,进入控制台即可找到API Key管理页面。建议在生成Key时备注用途(如“测试环境”、“生产环境”),便于后续管理。获取Key后,请妥善保存,不要在代码中明文硬编码,推荐使用环境变量加载。
如果不确定操作入口,可以直接访问 千聚AI中转站官网 查看文档指引。
第二步:确认Base URL与端点路径
千聚AI中转站全面兼容OpenAI API调用格式,因此Base URL结构也遵循OpenAI风格。接入GPT-4.1 mini模型时,需确认的Base URL格式为:
https://www.qianjuai.cc/v1
请务必注意末尾的 /v1 路径,不要遗漏。部分开发者容易将Base URL误写为其他格式,导致连接失败。建议复制控制台上展示的完整地址,避免手动输入错误。如果你使用的是Python的openai库或Node.js的axios库,配置方式如下:
- Python(openai 1.x+):
client = OpenAI(api_key="你的Key", base_url="https://www.qianjuai.cc/v1") - Node.js:
const configuration = { apiKey: "你的Key", baseURL: "https://www.qianjuai.cc/v1" }
如果使用其他语言或框架,只需将Base URL替换为上述地址即可。
第三步:确认模型名称与调用方式
不同平台的模型名称可能存在细微差异。千聚AI中转站统一使用标准化的模型标识符,GPT-4.1 mini的推荐调用名称为:
gpt-4.1-mini
在发起请求时,请确保模型名称字段填写正确。示例调用(Python):
response = client.chat.completions.create(model="gpt-4.1-mini", messages=[{"role": "user", "content": "Hello"}])
若返回模型不存在或401错误,请优先检查Key是否有效、Base URL末尾是否包含 /v1、模型名称是否与官方文档一致。千聚平台清单中亦包含其他主流模型,如Claude、Gemini、DeepSeek、Qwen等,切换模型时只需更改model参数,无需修改其他配置。
常见配置问题排查
| 问题现象 | 可能原因 | 解决建议 |
|---|---|---|
| 401 Unauthorized | API Key无效或已过期 | 重新生成Key并检查环境变量 |
| 404 Not Found | Base URL路径错误 | 确认结尾为 /v1 |
| 模型不存在 | 模型名称拼写错误 | 对照官网文档确认名称 |
| 请求超时 | 网络或代理配置问题 | 检查网络连接或更换节点 |
以上排查步骤适用于大多数接入场景。如果问题持续,建议查看千聚控制台中的调用日志,查看具体错误码。
Token购买与成本管理
千聚AI中转站支持按量购买Token,无需预存大额费用。开发者可根据实际调用量灵活充值,避免资源浪费。平台内提供余额管理、日消耗统计和模型用量明细,方便团队做成本归因。如果你需要为多个项目分配额度,还可以创建多个子Key并分别设置限额。具体价格与套餐请以 立即访问千聚 查看实时信息为准。
完成以上三步确认后,你就可以开始第一次模型调用测试了。建议先发送一个短文本请求验证连通性,再逐步增加并发量。千聚AI中转站的统一接口设计,让你未来切换到其他模型时无需重写核心代码,仅需修改model参数,大幅降低多模型接入的维护成本。
- 模型列表与API接入教程
- Token购买与余额充值
- OpenAI兼容接口配置指南
- 千聚官网最新文档
立即前往 千聚AI中转站官网 注册账号,获取API Key并开始你的第一次GPT-4.1 mini调用吧。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~