用 JavaScript／TypeScript 调用 Gemini API

前端与全栈工程师必看！基于 @google/generative-ai 官方 npm 包，编写现代化 TypeScript 异步调用代码与环境隔离方案。

一、依赖包安装与项目初始化

在 Node.js 项目根目录下运行：
npm install @google/generative-ai

二、标准 TypeScript 服务端调用代码

import { GoogleGenerativeAI } from "@google/generative-ai";

// 严格从服务端安全读取环境变量
const apiKey = process.env.GEMINI_API_KEY;
if (!apiKey) {
throw new Error("GEMINI_API_KEY 环境变量未设置");
}

const genAI = new GoogleGenerativeAI(apiKey);

async function main() {
const model = genAI.getGenerativeModel({ model: "gemini-1.5-flash" });
const result = await model.generateContent("为开源工具写三条吸引人的介绍口号。");
const response = await result.response;
console.log(response.text());
}

main().catch(console.error);

三、安全架构红线

严禁在 Vue 或 React 客户端代码中明文写入 API Key 直连谷歌接口，所有调用必须由后端服务或 API Route 统一中转。
基础配置见：[Gemini API 申请指南](https://aihuiyuan.club/articles/gemini-api-key-google-ai-studio-free)。