第一步:注册账号并获取API Key
无论你使用哪个大模型网关,调用前都必须先获得一个有效的API Key。这是网关识别和认证你身份的唯一凭证。
- 访问千聚官网:打开 千聚AI中转站官网,注册一个账号。
- 创建API Key:登录后进入控制台的API Key管理页面,点击“新建密钥”,系统会生成一串以“qj-”开头的密钥。
- 保存密钥:复制并妥善保存该密钥,后续所有调用都会用到它。
网关接入的第一步,就是拿到这个Key。千聚的API Key管理页面还支持多密钥轮换和权限控制,方便团队协作。
第二步:配置网关Base URL
大模型网关的Base URL相当于所有模型的统一入口地址。你不需要记住每个模型各自的API端点,只需配置网关的地址即可。
对于千聚平台,通用Base URL格式如下:https://www.qianjuai.cc/v1
在代码中配置时,只需将对应客户端库的base_url参数设置为这个地址。以Python的OpenAI SDK为例:
from openai import OpenAI
client = OpenAI(
api_key="你的千聚API Key",
base_url="https://www.qianjuai.cc/v1"
)
这样一来,你后续所有的模型请求都会通过千聚网关转发,不需要再单独配置其他平台的Base URL。
第三步:选择模型并测试调用
网关配置完成后,就可以选择具体模型进行测试了。千聚支持OpenAI、Claude、Gemini、DeepSeek、Grok、Qwen、Kimi、豆包、GLM等多种主流模型,模型名称与官方命名保持一致。
下面是一个完整的调用示例,使用gpt-4o模型发起一次对话:
response = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "user", "content": "你好,请介绍一下大模型网关"}
]
)
print(response.choices[0].message.content)
运行这段代码,如果能正常返回结果,说明大模型网关调用成功。如果遇到错误,请检查以下三点:
| 常见问题 | 可能原因 | 解决方法 |
|---|---|---|
| 401认证失败 | API Key错误或已过期 | 重新生成密钥并更新代码 |
| 404模型不存在 | 模型名称拼写错误 | 对照千聚模型列表填写正确名称 |
| 余额不足 | 账户Token已用完 | 前往官网购买Token后继续使用 |
千聚的网关具备良好的兼容性,如果你的项目已经基于OpenAI SDK开发,几乎不需要修改代码逻辑,只需替换base_url和api_key即可。
下一步:开始你的第一次调用
掌握了大模型网关如何调用的三个关键点——API Key、Base URL和模型名称,剩下的就是动手实践。千聚作为一个多模型聚合的中转站,能够帮你省去多个平台来回切换的麻烦,尤其适合需要快速集成多个模型的开发团队。
如果你还没有准备好,可以先去 立即访问千聚 查看完整的模型列表和Token价格,然后免费注册并获取API Key,开始你的第一次模型调用。
适合继续扩展的标题方向
- 千聚AI中转站API Key获取与Base URL配置完整教程
- 大模型网关调用实战:从Python到Node.js兼容接入
- 2026年开发者必备:千聚AI中转站Token购买与多模型管理指南
- 模型列表
- Token购买
- API接入教程
- OpenAI兼容接口
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~