凌晨两点，先让第一行代码真的回应你
凌晨两点的办公室，空调声像一条很慢的河，桌上半杯冷咖啡映着终端窗口。我第一次接 Gemini API，是为了给一个内容后台做“长文摘要+标签生成”。那晚最磨人的不是模型能力，而是一些小事：密钥放错位置、模型名写旧、请求超时、返回结构读错。技术常常不是宏大的，它更像夜里找钥匙——你知道门就在那儿，可手指总差一点摸到。
如果你在搜“Gemini API教程”“Gemini API怎么用”或“Gemini API接入Node.js”，先按官方免费路线走：准备 Google AI Studio 里的 API Key，本地装好 Node.js 18+ 或 Python 3.10+。免费额度适合开发测试，但高并发、长上下文和稳定性要看配额与地区网络；如果你已经习惯 Claude，也可能会顺手搜“Claude注册方法”“Claude怎么用”“Claude免费使用”，但两者接口、计费和模型特性不同，别把代码示例混用。
- 创建项目目录：
mkdir gemini-demo && cd gemini-demo - 初始化 Node 项目：
npm init -y - 安装 SDK：
npm install @google/generative-ai dotenv - 新建
.env：GEMINI_API_KEY=你的密钥
然后写一个最小可运行版本。我的习惯是先不要接数据库、不要接前端，先让模型在终端说一句清楚的话。
import 'dotenv/config';
import { GoogleGenerativeAI } from '@google/generative-ai';
const genAI = new GoogleGenerativeAI(process.env.GEMINI_API_KEY);
const model = genAI.getGenerativeModel({ model: 'gemini-1.5-flash' });
const result = await model.generateContent(
'用三句话解释：为什么API密钥不能写进前端代码？'
);
console.log(result.response.text());运行：node index.js。在我用普通家用宽带测试时，单次短文本响应大约 900ms 到 2.4s；如果超过 10s，先检查代理、DNS、模型名和密钥权限，而不是急着改业务代码。
把演示变成工具：摘要、标签与客服回复
真正有价值的 Gemini API开发，不是让它聊天，而是让它安静地嵌进流程。第一个案例是长文摘要。我给它固定输出 JSON，这样后端能直接入库，避免“今天像散文，明天像表格”的混乱。
const prompt = `
你是内容编辑。请把下面文章处理成JSON：
字段：summary不超过120字，tags为5个中文标签，risk提示可能的事实不确定点。
文章：
${articleText}
只返回JSON，不要解释。
`;这里的关键不是提示词写得多华丽，而是限制格式、限制长度、说明角色。测试时我用 20 篇 800 到 1500 字的文章做样本，人工检查 JSON 可解析率：第一次只有 17/20 成功；加上“只返回JSON，不要解释”后提升到 20/20。你看，所谓智能，有时也需要一点笨办法来扶稳。
第二个案例是客服草稿生成。不要让模型直接替你发消息，先让它生成“候选回复”，再由人工确认。提示词可以这样写：
请根据用户问题生成客服回复：
要求：语气温和，先确认问题，再给步骤；不承诺无法验证的结果。
用户问题：${question}
产品信息：${faqText}如果你担心幻觉，把 FAQ、订单规则、售后条款作为上下文传入，并要求“若资料中没有答案，回复：需要人工确认”。这句话很朴素，却能拦住很多看似自信的错误。
常见报错与如何验证它真的可用
最常见的坑有三个。第一，API key not valid，通常是密钥复制多了空格，或环境变量没加载；用 console.log(process.env.GEMINI_API_KEY?.slice(0,6)) 看看是否读到。第二，model not found，多半是模型名过期，换成当前可用的 gemini-1.5-flash 或控制台列出的模型。第三，返回内容不是 JSON，这不是程序错，而是约束不够，给它示例输出，并在代码里加 JSON.parse 失败重试一次。
如何验证它 works：准备 5 条固定输入，每条保存期望结果，例如“摘要不超过120字”“必须返回5个标签”“客服回复不能出现退款承诺”。连续运行 3 轮，记录成功率、平均耗时和失败原因。若 15 次里至少 14 次格式正确，平均响应低于 3 秒，业务字段能被解析，就可以进入小流量灰度；否则先别上线，夜里的系统最怕带着侥幸入睡。
免费与官方文档路线足够完成入门和原型；若你想顺手比较更多 AI生产力工具与接口实践，也可以把睿盈工具的整理页作为参考选项之一：wizzegroup.com。技术最后抵达的地方，仍是人的判断：让机器快一点，也让我们慢一点看清楚。