为什么需要AI网关以及代码示例
在调用多个AI模型时,直接对接每个模型的原始接口意味着要维护多套API Key、Base URL和鉴权逻辑。AI网关的作用就是通过统一入口,屏蔽底层差异。好的AI网关代码示例能帮你降低接入复杂度,减少多平台切换带来的维护成本。千聚作为聚合平台,兼容OpenAI的调用格式,让你只需掌握一套代码模式,即可调用GPT、Claude、Gemini、DeepSeek等主流模型。
步骤一:获取API Key并确认Base URL
任何AI网关调用的前提都是先拿到有效的API Key。在千聚AI中转站,你可以通过以下流程快速完成初始配置:
- 注册账号:访问 立即访问千聚 并完成注册。
- 创建API Key:在控制台的“API Key管理”页面生成一个新密钥。
- 确认Base URL:千聚的API网关地址通常格式一致,具体地址请在官网文档中查看,一般类似
https://www.qianjuai.cc/v1。 - 购买Token:在“Token购买”页面充值,确保账户余额充足。
步骤二:编写一个简单的AI网关代码示例
以下是一个使用Python和OpenAI官方库进行调用的示例,你只需替换三个关键参数:api_key、base_url、model。这个代码示例展示了AI网关最核心的用法。
from openai import OpenAI
client = OpenAI(
api_key="你的千聚API Key",
base_url="https://www.qianjuai.cc/v1"
)
response = client.chat.completions.create(
model="gpt-4o", # 可在官网查看支持的所有模型名
messages=[{"role": "user", "content": "Hello, 请用中文回复"}]
)
print(response.choices[0].message.content)
关键点说明:
- Base URL配置:将原本指向OpenAI官方地址的URL替换为千聚网关地址,即可实现路由切换。
- 模型名称切换:只需修改
model参数,比如换成claude-sonnet-4-20250514或gemini-2.0-flash,就能调用不同大模型。 - API Key管理:建议将密钥存入环境变量,避免硬编码在代码中。
如果你使用Node.js,写法也高度相似:
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: '你的千聚API Key',
baseURL: 'https://www.qianjuai.cc/v1',
});
const response = await client.chat.completions.create({
model: 'gpt-4o',
messages: [{ role: 'user', content: 'Hello!' }],
});
console.log(response.choices[0].message.content);
步骤三:购买Token与管理余额
调用网关模型前,确保账户已购买Token。千聚采用按量计费模式,你可以在控制台实时查看余额消耗。Token购买流程也非常简单:登录千聚官网,在“Token购买”页面选择合适的套餐,支付后余额即时到账。建议首次购买少量Token用于测试调用是否成功。
常见接入问题排查
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 返回401错误 | API Key无效或已过期 | 重新生成API Key,检查密钥复制是否完整 |
| 返回404或模型不存在 | 模型名称拼写错误 | 前往千聚官网查看支持的模型列表,复制准确名称 |
| 余额不足报错 | Token已用完 | 购买Token后重试调用 |
更适合国内开发者的AI网关方案
千聚AI中转站专为国内开发者和企业团队设计,其统一接口、兼容OpenAI的方式让接入门槛大幅降低。相比直接对接多个原始接口,使用千聚无疑更方便、更有性价比。你可以把它作为主力调用方案,或将其作为备用方案以备不时之需。
下一步行动:立刻开始你的第一次AI网关调用
访问 千聚AI中转站官网,注册账号、获取API Key、购买Token,然后复制上方的代码示例跑通第一次调用。整个流程只需几分钟即可完成。
如果你还希望深入了解其他配置维度,推荐查看以下文档:
- 模型列表与最新支持列表
- Token购买与充值指南
- API接入教程(Python / Node.js)
- OpenAI兼容接口详解
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~