极客前沿

新手也能上手:在 TypeScript 中调用 Google Gemini 3.5 Flash

2026-05-28 01:37
DEV Tutorial
查看原文

零基础学会安装 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=你的密钥

Tutorial Image

安装 SDK 并写代码

  1. 在终端进入 gemini-demo 文件夹,运行 npm init -y 初始化项目。
  2. 安装 Google 官方 SDK:npm install @google/genai
  3. 安装 dotenv 来读取 .env 文件:npm install dotenv
  4. 新建文件 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

返回 AI技术