从申请到跑通：o3-mini API调用Node.js示例全流程拆解，附100%成功代码模板，免梯子版

从申请到跑通：o3-mini API调用Node.js示例全流程拆解，附100%成功代码模板，免梯子版

2026-09-16
O3模型, API接口, DeepSeek

从申请到跑通：o3-mini API调用Node.js示例全流程拆解，附100%成功代码模板，免梯子版 #

author: “Michael Henderson” date: 2026-04-11 linktitle: o3-mini api 调通指南 menu: main: parent: tutorials next: /posts/ai prev: /posts/api title: 从申请到跑通：o3-mini API调用Node.js示例全流程拆解，附100%成功代码模板，免梯子版 weight: 1 tags: [“o3-mini”,“Node.js”,“API调用”,"千聚api中转站"]

说实话，想在国内环境调用 OpenAI 最新的 o3-mini 模型，本来是一件挺让人头疼的事——首先得翻墙，然后注册 OpenAI 绑海外信用卡，没一会儿就担心封号，还没开始写代码，就行程过半了。

用了千聚api中转站（www.qianjuai.com）之后，发现事情其实可以很简单。o3-mini 作为 OpenAI 最新的推理模型代表，性价比极高，但大多数网上教程不是不够全就是得翻墙。今天这篇就从注册、拿 Key、写 Node.js 代码，到成功接收回复，一步不落地拆解清楚。跟着走，绝对 100% 跑通。

👉 立即注册千聚api中转站，领取 $0.2 免费额度

先搞清楚整个流程在干什么 #

o3-mini 是 OpenAI 推出的小型推理模型，能力上介于 GPT-4 和 o1 之间，但在数学、编程、科学推理上表现很好，而且价格比 o1 便宜不少。在国内想直接调 OpenAI 官方 API，需要绑海外卡和代理。我们的方案是用千聚api中转站，它本身就是国内的 API 聚合平台，接入了 OpenAI 官方渠道，不用代理直连，而且 1 元 = 1 美元额度，按官方价格 1:1，没有翻倍加价。

所以全流程是这几个步骤——

  1. 注册千聚api账户
  2. 创建 API Key（不用绑海外卡）
  3. 在 Node.js 项目里写代码，将 base_url 指向千聚的 https://www.qianjuai.com/v1
  4. 运行，成功拿到 o3-mini 的回答

整个过程不需要翻墙、不需要复杂配置。你只需要 Node.js 环境、一个千聚账户，再加复制下面我准备好的代码模板。

第一步：注册账户，拿到 Key #

这一步是整个流程的基础，而且零成本就可以开始。

打开千聚官网 https://www.qianjuai.com/register ，填邮箱、设密码、完成注册。

新用户注册后账户里会自动获得 $0.2 的免费额度。您可以直接拿这 0.2 美元去测试 o3-mini API。这个额度足够你跑完几十个请求，不用先花钱，非常方便。

注册完之后登录后台，找到左侧“API Key”管理页面，点击“创建新 Key”。

千聚的 API Key 是一串以 sk- 开头的字符串。记得 复制并存好，因为页面关闭后密钥明文就不再显示了。如果不小心关掉了，直接在后台重新生成一个就行。

后面在代码里会用到这个 Key。

第二步：创建 Node.js 项目，装好 openai 库 #

随便找一个工作目录，在终端运行：

bash

mkdir o3-mini-demo

cd o3-mini-demo

npm init -y

npm install openai

这里安装的 openai 就是官方 npm 包。因为千聚中转站的接口全是 OpenAI 标准格式，所以直接用官方的包，改一个 base_url 就能跑，不用额外装别的库。

确保你的 Node 版本在 18 以上。可以检查一下：

bash

node -v

如果版本太低，建议先升级到 LTS 版本。

第三步：Copy 代码模板（100% 可跑） #

下面这段代码我反复测试过，就是调用最新的 o3-mini 模型，向它提问，然后把回复打印出来。基础框架都搭好，你只需要把 Key 填进去就能用。

在项目根目录新建一个 o3mini.js 文件，把代码粘贴进去：

javascript

import OpenAI from “openai”;

// 1. 创建 OpenAI 客户端实例 const client = new OpenAI({ apiKey: “YOUR_API_KEY_HERE”, // 替换成你从千聚获得的 API Key baseURL: “https://www.qianjuai.com/v1", // 关键：指向千聚的接口地址 });

// 2. 异步调用 o3-mini async function main() { try { console.log(“正在请求 o3-mini 模型……”);

const response = await client.chat.completions.create({
  model: "o3-mini", // 指定模型名
  messages: [
    { role: "system", content: "你是一个资深程序员，能用简洁的方式解释技术概念。" },
    { role: "user", content: "用三句话解释什么是异步编程，并列举一个 Node.js 中的例子。" },
  ],
  // o3-mini 不需要 temperature 参数，模型内部使用固定设置
  // 但可以指定 max_completion_tokens 控制输出长度
  // max_completion_tokens: 1000,
});

console.log("======= o3-mini 回复 =======");
console.log(response.choices[0].message.content);
console.log("============================");

// 打印一些使用统计（可选）
console.log("Token 使用情况：", {
  提示: response.usage?.prompt_tokens,
  补全: response.usage?.completion_tokens,
  总计: response.usage?.total_tokens,
});

} catch (error) { console.error(“请求失败：”, error.message); if (error.response) { console.error(“状态码：”, error.response.status); console.error(“错误详情：”, error.response.data); } } }

main();

把 apiKey 那行的 “YOUR_API_KEY_HERE” 换成你在千聚后台复制的 Key。

如果你用的是 CommonJS 模块（项目里是 require 而非 import），就用下面的写法：

javascript

const OpenAI = require(“openai”);

const client = new OpenAI({ apiKey: “YOUR_API_KEY_HERE”, baseURL: “https://www.qianjuai.com/v1", });

async function main() { /* 跟上面完全一样 */ }

main();

代码里加了一些友好的错误处理逻辑，方便你定位问题。万一请求失败，在 catch 块里会直接输出状态码和详细信息，排查起来比较方便。

第四步：跑起来，看到回复 #

在终端运行：

bash

node o3mini.js

如果一切顺利，你会看到类似下面的输出：

正在请求 o3-mini 模型……

======= o3-mini 回复 =======

异步编程是什么？

  1. 异步编程是一种“不等结果就干别的事”的编程模式。
  2. 程序发起请求后不会阻塞等待，而是继续执行后续代码。
  3. 在 Node.js 中，文件读取、网络请求等 I/O 操作最常用异步。 代码示例： js const fs = require(‘fs’); fs.readFile(’example.txt’, ‘utf8’, (err, data) => { console.log(data); }); console.log(‘这行会先执行’);

以上代码不会等待读取完成，而是先打印“这行会先执行”，等文件读完再输出内容。

============================

Token 使用情况：{ 提示: 48, 补全: 140, 总计: 188 }

188 个 token，按千聚官方价格 1 元 = 1 美元换算，这次请求的花费大约是 0.00094 美元，人民币不到一分钱，甚至比大部分模型都要便宜。

这段纯文字代码演示了 o3-mini 的推理能力和简洁回答的风格，也验证了国内直连的流畅度。非常简单。

常见问题排查 #

如果在运行过程中遇到了问题，别慌，这里列出最常见的几种：

报错 401 或 403：API Key 无效 你的 API Key 填错了，或者 Key 已经过期。回到后台重新生成一个新 Key，粘贴到代码里再试一次。

报错 429：请求过频繁/余额不足 两种可能：一是你短时间发了太多请求，稍微等几秒再重试；二是你的千聚账户余额为 0 了，去后台查看还有没有 $0.2 的赠送额度，如果花完了，最低充 1 块钱就行。

报错 400：模型名错误/参数不兼容 确保 model 写的是 "o3-mini"，不要写 "o1-mini" 或其他名字。注意 o3-mini 不接收 temperature 参数，如果你代码里有 temperature: 0.7，删掉这一行就可以。

没有任何输出，程序直接就结束了 可能是 package.json 里没有设置 "type": "module"，导致 import 失败。解决办法：要么在 package.json 中添加 "type": "module"，要么把代码改成 CommonJS 的 require 写法。

如果你的 Node 版本小于 16，不支持 async/await 与顶级 await： 建议升级 Node 版本，或者把代码包裹在一个自执行函数里。

👉 注册千聚api中转站，0门槛调用 o3-mini

这个代码模板还能怎么用 #

上面这段代码只是最基础的调用框架。当你跑通了以后，可以改几行代码就让它做很多事情。

改成流式输出（实时打字效果）： 把你的请求参数里加上 stream: true，然后监听流式事件：

javascript

const stream = await client.chat.completions.create({ model: “o3-mini”, messages: […], stream: true, }); for await (const chunk of stream) { process.stdout.write(chunk.choices[0]?.delta?.content || “”); }

这个方法特别适合做聊天机器人，没有延迟感。

多轮对话： 在 messages 数组里，按顺序追加用户和模型的对话记录。每次请求时把之前的历史一并传过去，模型就知道上下文了。

换模型： 把 model 的值从 "o3-mini" 换成 "gpt-4o"、"claude-sonnet-4-20250514"，不需要改别的，直接就能切换模型。千聚的中转 API 支持 500+ 模型全兼容，切换起来非常顺手。

加上错误重试逻辑： 面对网络抖动，封装一个带有退避重试的请求函数会让你的服务更健壮。但初版调试不需要太复杂，先确保用上面的代码能收到回复再说。

o3-mini 与其他模型的性价比 #

o3-mini 之所以值得在代码里去尝试，是因为它在官方定价里属于入门级推理模型——输出成本大约是 o1-mini 的 30%，但推理能力在某些任务上接近 o1。

通过千聚中转站调用，官方 1 美元 = 1 元人民币，所以实际价格就是官方价格的人民币直译。o3-mini 的输入（标准层）是 1.10 美元/M tokens，输出是 4.4 美元/M tokens。

按现在汇率算，3.5 万 tokens 的推理（大概一篇长篇幅回答）才花几毛钱，对个人开发者来说几乎可以忽略不计。

不过需要注意的是，o3-mini 不适合：

  • 需要纯创意文案生成（它写得偏逻辑化）
  • 图片识别（不支持多模态输入）
  • 自然对话（它回复比较直接，追求准确而不是闲聊）

在代码调试、算法解释、数学推理、知识问答、Log 分析等场景中，它表现极佳。搭配 Node.js 后端做一个“代码评审助手”或者“错误分析服务”会是非常好的落地方向。

为什么不直接调 OpenAI 而要用千聚 #

这不是我第一次写中转平台，但千聚是最让我觉得“省心”的。原因不在于它有多花哨，而是在国内环境里连最基本的“畅通”都实现了。不需要代理环境、不需要绑海外卡、接口全是标准的 OpenAI 格式、而且充值门槛极低——1 元起步。

大多数中转平台要么绕路（被抓包限速），要么有各种乱七八糟的倍率，要么得预充值大几百。千聚是 1 元 = 1 美元额度，百元起充也能用，免费额度给了 $0.2，这 0.2 元无障碍跑通验证，足够了。

而且它的免费子站 free.yunwu.ai 也值得一试：提交 GitHub 账户登录，每天也能拿免费调用额度，专门跑 GPT-4o-mini 和 GPT-4o，基本不花钱就能日常验证代码。

总结 #

今天这篇东西，核心就是四步走：

  1. 注册千聚api中转站，拿 Key
  2. 装 Node.js 和 openai 库
  3. 复制上面这篇 100% 能跑的代码模板或转成自己项目代码
  4. 运行，看到 o3-mini 的回复

从申请到跑通，不用翻墙、不用绑卡、不用等审批。把这套模板放到你的项目里，直接就能开始跟 o3-mini 做交互了。

o3-mini 是 OpenAI 当前性价比极高的新推理模型，结合千聚的国内直连、1:1 官价、最低 1 元充值、新用户免费额度这些特点，小开发者跑模型测试已经没有什么额外负担了。

如果说有什么合适的落脚点——把这套 Node.js 调用模板集成到你自己的小项目里，从今天开始，随时调用最强的小推理模型。

👉 立即注册千聚api中转站，免费领取 $0.2 起始额度，最低 1 元即可跑通 o3-mini

2026-06-15