2026最新可用：GPT-4o-mini模型接入Node.js示例全流程图文教程，小白也能一次跑通

2026最新可用：GPT-4o-mini模型接入Node.js示例全流程图文教程，小白也能一次跑通

2026-10-13
ChatGPT, DeepSeek, AI模型

2026最新可用：GPT-4o-mini模型接入Node.js示例全流程图文教程，小白也能一次跑通 #

说实话，想用上 GPT-4o-mini 这样的模型做点小工具，Node.js 环境里写个 API 调用，本身不算什么难事。但真正动手的时候，很多人的卡点根本不是代码——而是环境。

要注册海外账号、要找梯子、要绑信用卡、还要担心被封号……一套流程下来，代码一行没写，斗志已经被折腾掉了一半。

这篇教程，就是专门解决这个痛点的。我会带着你一步步，用国内可以直接调用的 API 中转站千聚AI聚合站，跑通一个完整的 GPT-4o-mini 接入 Node.js 示例。不用翻墙、不绑卡、不开神秘会员，一个简单的 Node.js 项目就能跑起来。

准备工作：注册千聚并获取 API Key #

在写第一行代码之前，我们需要先拿到调用大模型的门票。

第一步：注册账号

打开浏览器，访问千聚AI聚合站的官方网站：https://www.qianjuai.com/register。填写你的邮箱和密码，完成注册流程。新用户注册后会直接获得 $0.2 的免费消费额度，如果你只是想测试教程里的代码，这笔额度完全够用。

第二步：获取 API Key

登录千聚之后，在控制台左侧菜单找到“API Keys”一栏，点击进入。在这里，点击“创建新 API Key”。系统会生成一串类似 sk-qjxxxxx 的字符串，这就是你调用模型时的身份凭证。请你务必把这串 Key 复制下来，保存在一个安全的地方（比如本地的 .env 文件里）。出于安全考虑，页面关闭后你将无法再次查看完整的 Key。

环境搭建：一个干净简洁的 Node.js 项目 #

在你电脑的合适目录下，打开终端命令行工具，依次运行以下三个命令：

mkdir gpt4o-mini-demo cd gpt4o-mini-demo npm init -y

完成后，你会得到一个最基础的 package.json 文件。

安装依赖

我们在项目中只需要一个核心库：openai。这是 OpenAI 官方发布的 Node.js 库，完全兼容千聚的接口。在终端中继续运行：

npm install openai

安装成功后，新建一个名为 index.js 的文件，这便是我们测试代码的主入口。

核心代码：接入千聚的 GPT-4o-mini #

现在，让我们在本教程的核心部分编写代码。这里我会提供两种最常见的用法：非流式输出（一次性返回完整结果）和流式输出（逐字逐句输出，类似 ChatGPT 的实时打字效果）。两者同样简单。

场景一：非流式输出（适合单次问答） #

SSL证书问题在国内网络环境下偶尔会出现，千聚API默认配置了可靠的证书策略。用下面的代码，你可以安全地请求一次逻辑回答。

在 index.js 中写入以下代码：

javascript // 导入 OpenAI 库 import OpenAI from ‘openai’;

// 创建 OpenAI 客户端实例。最关键的是修改 baseURL 和 apiKey const client = new OpenAI({ baseURL: ‘https://www.qianjuai.com/v1', // 指向千聚API，不要填错 apiKey: ‘你的千聚API Key’ // 用你复制的 Key 替换这里 });

async function main() { console.log(‘正在向千聚API请求 GPT-4o-mini 回答…’);

const completion = await client.chat.completions.create({ model: ‘gpt-4o-mini’, // 模型名称，直接指定 messages: [ { role: ‘user’, content: ‘用一句话告诉我，为什么程序员都喜欢 Node.js？’ } ] });

// 打印 AI 的回答 console.log(‘AI回答:’, completion.choices[0].message.content); }

// 运行主函数 main();

解释这段代码做了什么：

  • 第3-7行：导入 openai 库，创建一个客户端实例。baseURL 直接填成千聚的接口地址 https://www.qianjuai.com/v1。API Key 换成你自己的。这一步连接了千聚的服务器。
  • 第15-21行：调用 chat.completions.create 方法，指定了模型为 gpt-4o-mini，并传入一个包含用户消息的数组。千聚平台会自动将该请求路由到最稳定的 ChatGPT 服务器。
  • 第25行：从返回结果中取出 AI 最终的文本回答，并打印到控制台。

场景二：流式输出（体验实时打字效果） #

如果想在终端看到逐字输出的效果，我们用 stream: true 模式。修改 index.js 中的代码：

javascript import OpenAI from ‘openai’;

const client = new OpenAI({ baseURL: ‘https://www.qianjuai.com/v1', apiKey: ‘你的千聚API Key’ // 替换这里 });

async function main() { console.log(‘流式输出开始：\n’);

// 开启流式输出 const stream = await client.chat.completions.create({ model: ‘gpt-4o-mini’, messages: [ { role: ‘user’, content: ‘用一句俏皮话概括 JavaScript 和 Python 的区别。’ } ], stream: true, // 关键参数 });

// 逐块读取处理返回的数据 for await (const chunk of stream) { // 提取并打印文本内容 process.stdout.write(chunk.choices[0]?.delta?.content || ‘’); } console.log(’\n\n流式输出结束。’); }

main();

流式代码的关键点：

  • 第16行：stream: true 告诉 API 我们需要流式响应。
  • 第19-21行：使用 for await 循环，每获取到一个数据块（chunk），就提取其中的文本片段并打印。process.stdout.write 确保所有输出都在同一行，模拟打字效果。

运行测试：见证奇迹的时刻 #

在终端中，确认你仍在项目根目录 gpt4o-mini-demo 下。

如果你是第一次使用 ES Module（import 语法），需要在 package.json 中添加字段。打开 package.json，在 "main": "index.js" 这一行后面添加一个逗号，并插入以下内容：

json “type”: “module”,

修改后，像这样：

json { “name”: “gpt4o-mini-demo”, “version”: “1.0.0”, “main”: “index.js”, “type”: “module”, … }

最后，在终端里运行：

node index.js

如果一切顺利，你将看到类似下面的输出（以非流式输出为例）：

正在向千聚API请求 GPT-4o-mini 回答… AI回答: 因为 Node.js 能让前端技术栈贯通全栈，一杯咖啡的功夫从前端写到后端，省心又省力。

恭喜你！你已经成功通过 Node.js 连接到千聚AI聚合站，并调用了 GPT-4o-mini 模型。整个过程没有翻墙，没有绑海外信用卡。

进阶技巧：轻松切换其他模型 #

千聚AI聚合站的另一个核心优势是兼容性极强。以前面的代码为例，你不需要修改框架逻辑，只需要改动一个地方——model 字段的名称，就可以瞬间切换到其他数百个模型。

比如，你想用强大的 DeepSeek-V3 做推理，只需要将代码改为：

javascript model: ‘deepseek-v3’,

如果想用它内部成本极低的 DeepSeek-R1 模型：

javascript model: ‘deepseek-r1’,

想试试 Gemini 2.5 Flash：

javascript model: ‘gemini-2.5-flash’,

这些模型在千聚平台上都已经配置好，费率公开透明，你可以随时在平台官网查看具体定价。1 元人民币 = 1 美元 Token 额度，按官方价格 1:1 计费，用不起？不存在。最低 1 元起充，门槛极低。

避坑指南：常见问题与排错 #

开发者之路，多多少少会碰到一些坑。下面列出几个新手最容易遇到的问题和对应的解决方案。

问题一：SSL 证书错误 / 连接被拒绝

  • 原因：某些网络环境或 Node.js 版本对自签名证书不信任。

  • 解决方案：在创建 OpenAI 客户端时，增加一个配置项： javascript const client = new OpenAI({ baseURL: ‘https://www.qianjuai.com/v1', apiKey: ‘你的Key’, defaultQuery: { ‘ssl_verify’: ‘false’ } // 禁用SSL验证（仅开发环境建议） });

    推荐方案：千聚官方建议用户设置环境变量 NODE_TLS_REJECT_UNAUTHORIZED=0 后再运行程序。或者，直接联系千聚的客服，他们可以帮你排查特定地区的节点问题。

问题二：超时错误

  • 原因：请求体太大或模型推理时间较长。
  • 解决方案：设置更长的超时时间： javascript const client = new OpenAI({ baseURL: ‘https://www.qianjuai.com/v1', apiKey: ‘你的Key’, timeout: 30000, // 30秒超时（默认是10秒） });

问题三：返回内容乱码

  • 原因：控制台编码问题。
  • 解决方案：在终端中运行前，先执行 chcp 65001（Windows）或将终端编码设为 UTF-8。如果是 VSCode 内置终端，通常已默认为 UTF-8。

总结：你起飞的第一步 #

GPT-4o-mini 是目前性价比很高的模型之一，配合千聚AI聚合站，你可以轻松在国内网络环境下进行开发、测试甚至生产部署。

回过头来看，你做了什么？

  1. 花了 3 分钟注册了 千聚AI聚合站 并拿到了 API Key。
  2. 用 5 分钟安装了一个 openai 库。
  3. 粘贴了两段代码，前后加起来不到 50 行。
  4. 运行成功了。

从零到一，就是这么简单。没有复杂的 Webpack 配置，不需要解决代理和翻墙问题。

👉 注册千聚API，领取新用户免费额度，立即开始你的第一个 Node.js AI 项目

2026-06-15