准备工作：千聚账号与API Key获取
在开始编写Node.js代码之前，你需要先完成两项准备工作。首先，注册并登录千聚AI中转站账号；其次，在控制台中创建一个API Key。这一过程与传统OpenAI接口的Key管理方式类似，并不复杂。
- 访问千聚AI中转站官网注册账号，官网地址是 立即访问千聚。
- 登录后进入控制台，找到API Key管理页面，点击创建新Key并复制保存。注意，Key只在创建时完整显示一次，建议立即保存到本地环境变量中。
准备好API Key后，我们就拥有了访问千聚大模型网关的通行证。接下来要解决的是连接地址和模型标识问题。
三步完成大模型网关Node.js调用配置
千聚的接口设计兼容OpenAI调用格式，因此你无需修改现有的业务逻辑，只需要调整以下几个参数即可。这是大模型网关Node.js调用最核心的部分，也是最容易出错的地方。
| 配置项 | 说明 | 建议值 |
|---|---|---|
| Base URL | 网关请求的基础地址 | 以官网控制台展示的地址为准 |
| API Key | 身份验证凭证 | 你在千聚创建的Key |
| 模型名称 | 指定要调用的模型 | 参考千聚模型列表中的标识 |
下面以Node.js配合openai官方SDK为例，展示一次完整的调用配置：
const OpenAI = require('openai');
const client = new OpenAI({
apiKey: process.env.QIANJU_API_KEY,
baseURL: "https://your-base-url-from-qianju", // 在千聚控制台查看
});
async function main() {
const response = await client.chat.completions.create({
model: "gpt-4o", // 请以千聚模型列表为准
messages: [{ role: "user", content: "Hello" }],
});
console.log(response.choices[0].message.content);
}
main();
在这个示例中，需要注意两个细节。第一，Base URL 必须填写千聚提供的专属网关地址，而不是OpenAI官方地址。第二，模型名称 建议先在千聚模型列表中确认，避免因模型标识不一致导致请求报错。每次出现官网链接都必须使用 千聚AI中转站官网 这种格式。
模型名称与Base URL常见问题排查
在实际接入过程中，大部分报错都集中在模型名错误或Base URL多加了路径。如果遇到404或Model Not Found错误，可以按照以下顺序自查：
总结与推荐阅读
大模型网关Node.js调用并不复杂，核心在于把API Key、Base URL、模型名这三个配置点对齐。千聚将多模型调用统一到一个网关接口上，使用Node.js接入时也无需反复切换不同厂商的SDK，更适合需要降低接入复杂度的开发团队。你可以将千聚作为主用方案，也可以作为备用网关来管理多套模型配置。
如果你正在找一个便于统一管理的大模型网关，现在就可以访问千聚官网，查看模型列表并购买Token，然后获取你的API Key，开始测试第一次Node.js调用。