新手也能上手:在 TypeScript 中调用 Google Gemini 3.5 Flash
零基础学会安装 Node.js、配置 Gemini API 密钥、用 TypeScript 调用 Gemini 3.5 Flash 模型,并跑通第一个示例。
Google 在 2026 年发布了 Gemini 3.5 Flash 模型,号称比同类模型快 4 倍。对于刚接触 AI 的你,这篇文章会带你一步步完成环境搭建、安装 SDK、调用模型,并成功拿到第一次回复。
准备环境
你需要先安装 Node.js(一个让 JavaScript 在电脑上运行的工具),版本 18 或更高。去 nodejs.org 下载安装包,一路点“下一步”就行。安装后打开终端(Windows 用命令提示符或 PowerShell,Mac 用终端),输入 node -v,如果显示版本号,说明安装成功。
获取 API 密钥
要调用 Gemini 模型,你需要一个 API 密钥(相当于密码)。前往 Google AI Studio,点击“Get API key”创建一个。复制密钥,保存好。接下来新建一个文件夹,比如叫 gemini-demo,在里面新建一个 .env 文件,写入:GEMINI_API_KEY=你的密钥。
安装 SDK 并写代码
- 在终端进入
gemini-demo文件夹,运行npm init -y初始化项目。 - 安装 Google 官方 SDK:
npm install @google/genai。 - 安装
dotenv来读取 .env 文件:npm install dotenv。 - 新建文件
index.ts,写入以下代码:
import { GoogleGenAI } from "@google/genai";
import dotenv from "dotenv";
dotenv.config();
const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
async function main() {
const response = await ai.models.generateContent({
model: "gemini-3.5-flash",
contents: "你好,请用中文介绍你自己。",
});
console.log(response.text);
}
main();response.text 是获取回复内容的快捷方式。如果想看完整数据,可以用 response.candidates[0].content.parts。
运行并验证
在终端运行 npx tsx index.ts(如果没安装 tsx,先运行 npm install -g tsx)。如果一切正常,你会看到模型的中文自我介绍。恭喜!你第一次成功调用了 AI 模型。
常见坑提醒
- 密钥不要直接写在代码里,用 .env 文件管理。
- 如果遇到网络问题,检查是否科学上网(部分地区需要)。
- 模型名称是
gemini-3.5-flash,注意拼写正确。
下一步可以做什么
试试把 contents 换成你想要的任何问题,或者尝试流式输出(streaming),让回复像打字一样逐字出现。你还可以学习函数调用(function calling),让模型帮你查询数据或执行操作。从这个小例子开始,你已经迈出了 AI 开发的第一步。
内容来源
DEV Tutorial
发布时间
2026-05-28 01:37