必须先完成node.js 20+环境配置、安装@google/genai sdk并安全接入api密钥，否则调用将因认证失败或模块缺失中断；验证通过后可成功调用gemini-2.5-flash生成文本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Node.js项目中调用Gemini API完成文本生成、多轮对话或文件理解等任务，必须先完成JavaScript运行环境配置、SDK安装与密钥安全接入，否则所有后续调用都会因认证失败或模块缺失而中断。
检查并升级Node.js环境
js-genai SDK要求Node.js 20+版本，低于此版本会触发ERR_MODULE_NOT_FOUND或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 model not found错误。
安装成功后，node_modules/@google/genai目录下应存在dist/index.d.ts类型声明文件。
安全配置API密钥
方法一：使用.env文件（推荐开发阶段）
在项目根目录创建.env文件，写入：GEMINI_API_KEY=your_actual_api_key_here。
⚠️注意：该文件必须加入.gitignore，否则密钥将被提交至远程仓库——【一旦泄露，他人可立即盗用你的配额并产生费用】。
使用 Google GenAI SDK 通过 Gemini 生成或编辑图像。当用户要求在 OpenCla… 中创建、转换、渲染或保存一张或多张图像时使用。
方法二：系统环境变量（适合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。
若控制台输出类似“量子纠缠是粒子间瞬时关联现象，测量一个粒子状态会立即决定另一个的状态”的文本，说明集成成功。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
