Node.js集成Gemini API：JavaScript环境搭建与调用示例

想在 Node.js 项目中调用 Gemini API 实现文本生成、多轮对话或文件理解功能？首先需要确保环境准备工作到位——Node.js 版本、SDK 安装、API 密钥安全接入，这三步缺一不可。任何一步没有到位，调用都会失败。

先从最基础的 JavaScript 环境开始。这一步如果搞不定，后面的一切都无从谈起。

检查并升级 Node.js 环境

js-genai SDK 要求 Node.js 20 及以上版本，低于这个版本运行时，会出现模块找不到或 ESM 语法错误。在终端里输入 node -v，查看当前版本号。

如果输出为 v18.x 或更低版本，需要卸载旧版，然后从 nodejs.org 下载 LTS 版本（v20.15.1）重新安装。旧版本无法解析 export * as 这类语法，会导致 @google/genai 导入失败——这是很多新手常踩的坑。

安装后再次运行 node -v，确认版本号为 v20.15.1 或更高。

创建项目并安装最新 SDK

找一个空目录，依次执行 npm init -y 和 npm install @google/genai。

这里有一个关键点：必须安装 @google/genai，而不是已经废弃的 @google/generative-ai。后者自 2026 年 4 月起已停止维护，使用它调用 gemini-2.5-flash 这类新模型时，会直接返回 404 错误，提示找不到模型。

安装成功后，前往 node_modules/@google/genai 目录查看，应该能看到 dist/index.d.ts 这个类型声明文件。

安全配置 API 密钥

**方法一：使用 .env 文件（推荐开发阶段使用）**

在项目根目录新建一个 .env 文件，写入 GEMINI_API_KEY=your_actual_api_key_here。

⚠️ 注意：这个文件必须添加到 .gitignore 中，关键信息切勿提交到远程仓库——一旦泄露，他人可以直接盗用你的配额并产生费用，风险不容忽视。

**方法二：系统环境变量（适合 CI/CD 场景）**

在 Linux/macOS 终端中执行 export GEMINI_API_KEY="your_key"；在 Windows PowerShell 中执行 $env:GEMINI_API_KEY="your_key"。

验证是否生效也很简单：在 Node.js 中运行 console.log(process.env.GEMINI_API_KEY)，应该能看到密钥字符串，而不是 undefined。

初始化客户端并发起首次调用

第一步：新建 app.js，写入以下代码：

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

第二步：添加异步调用函数：

async function testCall() {
const result = await ai.models.generateContent({
model: "gemini-2.5-flash",
contents: "用中文解释量子纠缠，不超过50字"
});
console.log(result.text);
}
testCall();

第三步：使用 ESM 模式启动：node --experimental-specifier-resolution=node app.js。

如果控制台输出类似“量子纠缠是粒子间瞬时关联现象，测量一个粒子状态会立即决定另一个的状态”的内容，说明集成成功。现在可以继续探索更多功能了。

你是一名 AI 行业编辑，请围绕下面这条热点输出一份资讯解读：
热点：Node.js集成Gemini API：JavaScript环境搭建与调用示例要求：
1. 先用一句话解释这条热点在讲什么
2. 再总结它为什么重要
3. 说明会影响哪些 AI 产品或内容方向
4. 最后给出 3 个适合资讯站使用的标题