博主贴心提示：在阅读任何一篇前，先准备好你的Node.js环境和API密钥。跟紧我，保证你踩中任何一个坑都算我输！

博主贴心提示：在阅读任何一篇前，先准备好你的Node.js环境和API密钥。跟紧我，保证你踩中任何一个坑都算我输！

2026-07-14
API接口, Claude, 大模型

博主贴心提示：在阅读任何一篇前，先准备好你的Node.js环境和API密钥。跟紧我，保证你踩中任何一个坑都算我输！ #

说实话，我一直觉得，网上那些API教程最坑的地方，不是它讲的内容不对，而是那个“准备环境”的步骤，往往被一笔带过。然后一群人跟着敲代码，结果一大半时间都卡在配环境、认证失败、连不通这些破事儿上。

今天这篇，是我自己的“血泪史”总结。我想用最“不折腾”的方式，告诉你如何用Node.js，把这个步骤走完。

先别急着翻代码，把你的Node.js环境准备好（没装的就去看官网装一个），再花两分钟去注册一个千聚ai聚合平台的账号。然后，跟我来。我保证，这次你一个坑都不会踩。

第一步：你真的把 Node.js 和 KEY 备好了吗？ #

我们开始前，有两样东西你必须已经拿在手里。

  1. Node.js 环境：版本要求不算高，16.x 以上基本就够用了。如果你还在用 12 或更老的，建议先去官网升级一下。怎么安装我就不啰嗦了，网上教程一搜一大堆，记住装完在终端输入 node -v 检查版本就行。

  2. API 密钥：这是你访问大模型的“钥匙”。没有它，你写再多代码也是白搭。

这个密钥从哪里来？去千聚ai聚合平台的官方网站（www.qianjuai.com）注册一个账号。注册完，你就能在后台的“API管理”页面，创建一个专属的API Key。

博主提醒： 注册新用户，平台会送你 $0.2 的试用额度。别担心，先白嫖，觉得好用再充钱。这个额度足够你完成接下来的所有测试，甚至写个小 Demo 玩玩。

👉 先花两分钟，在这儿注册领额度

第二步：一个最简单的测试脚本 #

拿到 Key 之后，我们开始干正事。

创建一个新文件夹，比如叫 test-ai，然后在终端里进入这个文件夹。初始化一下项目：

bash npm init -y

然后安装 OpenAI 的 Node.js 库。注意，这个库不仅支持 OpenAI，也完全兼容千聚ai聚合平台的接口。

bash npm install openai

好了，环境搭好了，接下来是写代码。

新建一个文件，叫 test.js，把下面的代码复制进去，记得修改两个地方：

  • apiKey：换成你在千聚ai聚合平台后台创建的 Key。
  • baseURL：这行代码我直接写好了，你不用再到处找。

javascript // test.js const OpenAI = require(‘openai’);

const client = new OpenAI({ apiKey: ‘这里填你在千聚ai后台拿到的Key’, // 修改这里 baseURL: ‘https://www.qianjuai.com/v1' // 这个地址是对的，别改错 });

async function main() { try { const completion = await client.chat.completions.create({ model: ‘gpt-4o’, // 你可以试试其他模型，比如 claude-3-haiku messages: [ { role: ‘user’, content: ‘用一句话解释什么是API’ } ], });

console.log('✅ 连接成功！AI的回答是：');
console.log(completion.choices[0]?.message?.content || '没有返回内容');

} catch (error) { console.error(’❌ 哎呀，出错了：’, error.message); } }

main();

保存文件，然后在终端运行：

bash node test.js

你应该能看到类似这样的输出：

✅ 连接成功！AI的回答是： API是应用程序编程接口的缩写，它允许不同的软件应用之间相互通信和数据交换。

如果你看到了这个，恭喜你！你已经成功接入了，一个坑都没有踩。如果报错了，别急，90% 的问题都在第三步。

第三步：帮你排查 99% 的常见错误（博主版） #

如果上面的代码跑不通，别慌。先看看是不是下面这几个问题：

1. 密钥写错了？或者额度用光了？ #

这是最常见的原因。检查一下你 test.js 里的 apiKey 有没有粘贴对，有没有多一个空格。

另外，去千聚ai后台看看，你的 $0.2 额度是不是用完了。新用户额度虽小，但足够测试，如果你之前调用了其他更贵的模型把它烧光了，那可能需要充值。最低1块钱就能充，支持支付宝，没什么门槛。

2. baseURL 写对了没？ #

再检查一遍。对于千聚ai聚合平台，地址必须是 https://www.qianjuai.com/v1，后面绝对不能有其他路径或者多余的斜杠。少一个字母或者多一个字符，都会调用失败。

3. 网络问题？防火墙？ #

千聚ai聚合平台是国内直连的，不需要科学上网。如果你在公司内网，可以问问IT是不是有网络白名单限制。如果你用的是个人网络，99.9% 的情况都能直连成功。

4. 模型名字写对了？ #

我上面的代码用的是 gpt-4o，你也可以试试 gpt-4o-mini 或者 deepseek-chat。但名字一定要写对，可以去平台文档里查看最新的模型列表。

第四步：把你的 LangChain 或 Cursor 也接上 #

刚才那个是单纯的 Node.js 调用。如果你在用 LangChain 或者 LlamaIndex 这种框架，怎么接？

极简版本： 框架里设置 API 地址的地方，一律改成 https://www.qianjuai.com/v1，然后把你的 API Key 填进去。

举个例子，LangChain 里的用法：

javascript import { ChatOpenAI } from ‘@langchain/openai’;

const model = new ChatOpenAI({ apiKey: process.env.QIANJU_API_KEY, // 建议用环境变量 configuration: { baseURL: ‘https://www.qianjuai.com/v1' } });

如果你在用 Cursor、Cline 或者 LobeChat：

这些工具在设置里通常有一个“自定义 API 地址”或者“OpenAI Proxy”的选项。直接填 https://www.qianjuai.com/v1，然后把 Key 填进去，就等于给它们装上了国内直连的“超级引擎”。

第五步：博主进阶提示，别走弯路 #

现在你已经跑通了，我再说两个“过来人”才懂的细节：

  • 充多少合适？ 先充 10 块钱。对于写代码、翻译、写文档这些日常任务，10块钱能让你用好一阵子了。别忘了，千聚的定价是 1 元人民币 = 1 美元 Token 额度。你花 10 块钱，就能买到 OpenAI 官方标价 10 美金才能买到的 Token 量。很多模型还有限时特价分组，倍率低至 0.6，更划算。

  • API Key 会过期吗？ 千聚ai平台的 API Key 余额永不过期。没错，你充了钱，放在那里，半年后拿出来还能用。这一点真的超良心，很多平台充了钱三个月不用就给你清了。

  • 想换模型？ 看到我代码里那个 model: 'gpt-4o' 了吗？只改这一行，就能切换成其他 500+ 模型。比如你想用 DeepSeek 做推理，改 model: 'deepseek-reasoner' 就行。这套代码是通用的，省心。

总结 #

这篇不算长，但核心就是让你无痛起步。

  1. 准备好 Node.js。
  2. 去 千聚ai聚合平台 注册并拿到 API Key。
  3. 复制代码，改两个地方，跑起来。
  4. 学会通用排查方法，以后遇到任何问题都能自己搞定。

环境配好，密钥拿到，剩下的就是跟着我走。相信我，这是你在国内做 AI 开发，最稳妥、最不折腾的一条路。

👉 还没注册的，赶紧去领免费额度，从零开始

2026-06-13