准备工作:注册账号并获取API Key
无论你选择哪个平台,第一步都是注册并获取一组可用的API Key。如果是使用千聚AI中转站,注册流程非常简洁,注册后即可在控制台生成一个专属的API Key。这个Key将用于后续所有模型的鉴权请求。
操作步骤:
千聚支持OpenAI、GPT-5系列、Claude、Gemini、DeepSeek、Grok、Qwen、Kimi、豆包、GLM等主流模型,一个API Key即可管理所有模型的调用,减少多平台切换的成本。
Node.js环境配置与Base URL设置
在Node.js项目中,推荐使用官方提供的openai npm包,因为千聚完全兼容OpenAI接口格式,无需额外适配。你只需要修改Base URL和API Key即可。
安装依赖:
npm install openai
配置示例:
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: '你的千聚API Key', // 替换为实际Key
baseURL: 'https://www.qianjuai.cc/v1' // 千聚提供的Base URL
});
注意:这里的baseURL是千聚统一入口,所有模型都通过这个地址调用,无需为每个模型单独配置不同的Base URL。这也正是大模型聚合平台Node.js调用的核心优势——统一接口,统一管理。
模型选择与首次调用测试
配置完成后,就可以开始第一次模型调用。在千聚中,模型名称使用官方命名规则,例如gpt-5、claude-4、deepseek-chat等。你可以在官网查看完整的模型列表。
以下是一个简单的对话调用示例:
async function main() {
const completion = await client.chat.completions.create({
model: 'gpt-5', // 可替换为其他模型名称
messages: [{ role: 'user', content: '你好,请介绍一下你自己。' }],
});
console.log(completion.choices[0].message.content);
}
main();
执行后,如果返回正常,说明你已经成功完成了大模型聚合平台Node.js调用。你可以随时更换model字段的值,切换到Claude、DeepSeek或其他模型,代码结构完全不变。这种灵活性对于需要对比多个模型输出质量的场景尤其有用。
Token管理与按量使用
千聚采用按量计费模式,购买Token后即可使用。你可以在控制台实时查看余额、用量统计和调用记录,无需担心超支。Token购买入口在官网的“充值中心”板块,支持多种支付方式,购买后立即到账。
建议首次使用时先购买少量Token进行测试,确认调用链路稳定后再按需补充。千聚的Token余额可以在多个项目之间共享,适合团队统一管理。
常见问题排查
| 问题 | 可能原因 | 解决方式 |
|---|---|---|
| 401认证错误 | API Key错误或过期 | 重新生成Key并更新代码 |
| 404模型不存在 | 模型名称拼写错误 | 前往官网模型列表核对名称 |
| 请求超时 | 网络环境或代理问题 | 检查网络,或尝试更换DNS |
| 余额不足 | Token已用完 | 在控制台充值Token |
如果遇到其他问题,可以查看千聚官网的文档中心,或直接联系客服支持。
立即开始你的第一次调用
现在你已经掌握了从API Key获取到Node.js模型调用的完整流程。下一步就是动手实践:
- 访问 立即访问千聚 注册账号并获取API Key。
- 在官网查看完整的模型列表和Token价格。
- 将上面的Node.js代码复制到你的项目中,替换API Key和模型名称,运行测试。
用千聚,你只需要一个Base URL和一套API Key,就能调用市面上主流的AI模型,大幅降低接入与维护成本。
- 模型列表
- Token购买
- API接入教程
- OpenAI兼容接口
- 千聚官网