OpenAI SDK for JavaScript (Node.js)：完整指南与代码示例

欢迎阅读这份最全面的 OpenAI SDK for JavaScript (Node.js) 使用指南。本文专为 PythonLib 教育门户编写，旨在帮助不同水平的开发者快速、高效地将 OpenAI 的人工智能能力集成到网页应用、聊天机器人和后端解决方案中。

1. 什么是 OpenAI SDK 以及为什么需要它

OpenAI SDK for JavaScript 是 OpenAI 官方提供的库，用于在 JavaScript (Node.js) 应用中与其 API 进行交互。它是对 REST API 的便捷封装，自动处理所有繁琐工作：构建 HTTP 请求、处理响应、管理身份验证、网络错误重试以及数据流式传输 (streaming)。您无需手动编写 fetch 请求、解析 JSON 或管理令牌，只需使用直观的方法名即可——例如 chat.completions.create()、embeddings.create()、images.generate() 等。

为什么需要这个库？首先，它能极大加速开发。原本需要几十行代码才能完成的 ChatGPT 请求，现在只需 3-5 行。其次，SDK 自动处理流式传输等复杂功能——当模型响应分块到达时，这对于构建实时显示文本的聊天界面至关重要。第三，该库开箱即用地支持 TypeScript，为所有请求和响应提供完整类型定义，让您在编码阶段就能捕获错误，而非运行时。最后，作为官方工具，它会随 API 同步更新，确保您始终能访问最新模型和功能，如 GPT-4o、DALL-E 3、Whisper 和 TTS。

这个库非常适合构建聊天机器人、智能助手、文本分析系统、内容生成、翻译、摘要，以及与 Express.js、Next.js 或 Telegram Bot API 等框架的集成。如果您使用 Node.js 并希望为项目添加 OpenAI 的“大脑”——这个 SDK 就是您的最佳选择。

2. 安装

通过标准 npm 包管理器安装该库。请确保您已安装 Node.js 18 或更高版本（推荐 20 LTS）。

安装命令如下：

npm install openai

如果您使用 yarn：

yarn add openai

安装后，您需要一个 OpenAI API 密钥才能使用。您可以在 platform.openai.com/api-keys 获取密钥。请安全存储密钥，例如放在环境变量 OPENAI_API_KEY 中。

3. 快速入门——最小化工作示例

让我们编写一个最简单的脚本，向 GPT-4o 模型提问并输出答案。创建文件 quickstart.mjs（使用 ES 模块）或 quickstart.js（用于 CommonJS）。

// quickstart.mjs — 使用 ES 模块
import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: process.env["OPENAI_API_KEY"], // 从环境变量获取密钥
});

async function main() {
  const completion = await openai.chat.completions.create({
    model: "gpt-4o",
    messages: [
      { role: "system", content: "你是一个有用的助手。" },
      { role: "user", content: "用中文写一句简短的问候。" },
    ],
  });

  console.log(completion.choices[0].message.content);
}

main();

运行脚本：

export OPENAI_API_KEY="sk-..." # Linux/macOS
set OPENAI_API_KEY="sk-..."    # Windows
node quickstart.mjs