第一步：准备工作——注册账号与获取API Key
在开始编写Node.js代码之前，你需要先拥有一个可用的API Key。千聚AI中转站（简称“千聚”）支持通过邮箱快速注册，注册后即可在后台管理页面生成专属的API Key。建议在生成后立即复制并妥善保存，因为后续的Base URL配置和模型调用都依赖这个密钥。
- 访问 立即访问千聚 完成注册。
- 在控制台中找到“API Key管理”栏目，创建新密钥。
- 同时，在后台查看自己的Base URL地址，通常格式为
https://www.qianjuai.cc/v1。
国内用户无需额外配置代理，千聚的API网关直接兼容OpenAI的接口规范，极大降低了Node.js调用的接入复杂度。
第二步：配置Node.js环境与Base URL
在Node.js项目中，你可以在环境变量中统一管理API Key和Base URL，避免硬编码带来的安全隐患。以下是两种常见的配置方式：
| 配置项 | 变量名 | 示例值 |
|---|---|---|
| API Key | OPENAI_API_KEY |
sk-xxxxxxxxxxxxxxxxxxxx |
| Base URL | OPENAI_BASE_URL |
https://www.qianjuai.cc/v1 |
建议使用 dotenv 包加载环境变量。这样，当你在千聚后台切换模型时，只需修改模型名称，而无需改动代码中的Base URL和API Key，真正实现“一次配置，多模型调用”。
第三步：编写Node.js调用代码
以下是一个基于OpenAI官方Node.js SDK的最小调用示例，展示了如何通过千聚的API网关调用模型：
const OpenAI = require('openai');
const client = new OpenAI({
apiKey: process.env.OPENAI_API_KEY,
baseURL: process.env.OPENAI_BASE_URL
});
const response = await client.chat.completions.create({
model: 'gpt-4o',
messages: [{ role: 'user', content: '你好，请用中文回复' }]
});
console.log(response.choices[0].message.content);
注意：代码中的 baseURL 必须替换为你从千聚后台获取的地址，model 参数则填写千聚支持的模型名称（如 gpt-4o、claude-sonnet-4-20250514、deepseek-chat 等）。千聚的API网关支持实时切换模型，你可以在后台查看完整的模型列表。
第四步：测试调用与常见问题排查
运行上述代码，如果返回正常结果，说明接入成功。如果遇到错误，常见原因包括：
- 401 认证失败：检查API Key是否复制完整，或是否已在千聚后台充值Token。
- 404 模型不存在：确认模型名称是否与千聚列表中的名称完全一致（注意大小写和连字符）。
- 余额不足：登录千聚后台查看账户余额，并及时购买Token。
千聚的API网关支持按量计费，且余额管理界面清晰，可随时查看历史调用记录与Token消耗明细。对于Node.js开发者来说，这比逐个对接多平台API Key要方便得多。
下一步行动：现在你就可以开始接入。先访问 千聚AI中转站官网 注册账号，生成你的API Key，然后复制Base URL，用上面的代码跑一次测试。如果遇到模型选择或Token购买问题，可以直接在官网查看实时信息。