夜里两点，先让接口真正回一句话
凌晨两点的办公室，空调风像很轻的白噪音，桌上半杯冷掉的茶映着终端窗口。我第一次调 Gemini API 时，也不是为了什么宏大的智能体，只是想让一堆用户反馈自动归类。技术有时很像深夜电台：你把问题送进黑暗里，等待另一端传回一句清楚的回答。可冲突也在这里——文档看得懂，代码却不一定跑得通；模型能聊天，业务却需要稳定输出。
如果你正在搜索“Gemini API教程”或“Gemini API怎么用”，建议先走官方免费路线：准备一个 Google 账号，在 Google AI Studio 创建 API Key，免费额度适合学习和小规模测试；限制是速率、地区访问和生产稳定性需要自己处理。不要一开始就堆框架，先用最小脚本验证链路。
- 安装 Node.js 18 以上版本，创建目录：
mkdir gemini-demo && cd gemini-demo && npm init -y - 安装 SDK：
npm install @google/generative-ai dotenv - 新建
.env：GEMINI_API_KEY=你的密钥 - 新建
index.js，写入下面代码。
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 prompt = '请用三句话总结：客户反馈发货慢、客服回复慢、包装破损。'; const result = await model.generateContent(prompt); console.log(result.response.text());
运行：node index.js。我在一台普通家用宽带、Node 20 环境测试，首次响应约 1.8 秒，后续多在 900ms 到 1.4 秒之间。这个数字不是承诺，只是给你一个判断网络和密钥是否正常的参照。
两个能落地的小案例：摘要与客服分流
第一个案例是会议纪要摘要。把一段 3000 字会议文本传给模型，要求固定 JSON 输出：议题、结论、负责人、截止时间。关键不是“让 AI 总结”，而是约束格式，否则后续程序没法接。提示词可以这样写：请只返回JSON，字段为 topic, decisions, owners, deadlines。不要解释。 如果输出偶尔带多余文字，就在代码里做一次 JSON 截取，或要求模型“若无信息则填空数组”。
第二个案例是客服工单分流。我的做法是先定义分类：物流、退款、质量、售后、其他；再让 Gemini 只返回类别和置信度。示例提示：你是客服分流器。根据用户内容返回 {"category":"","confidence":0-1,"reason":""}。用户：我买的烧杯有裂纹，想换货。 在 120 条历史工单的小测试里，人工抽查 30 条，分类一致 26 条，约 86.7%。真正上线前，建议保留人工复核入口，尤其是退款、投诉、法律风险类内容。
如果你也关注“Claude怎么用”“Claude免费使用”或“Claude注册方法”，可以把两者当成不同写作风格的工具：Claude 长文理解常被用于文档分析，Gemini API 则在 Google 生态和多模态场景里更方便。选择哪一个，不必靠情绪，拿同一批 50 条真实样本测试准确率、耗时和成本，答案会比争论诚实。
排错、上线前检查，以及如何确认它真的可用
常见错误有三类。第一，401 或 API key not valid，多半是密钥复制错、环境变量没加载，打印 process.env.GEMINI_API_KEY?.slice(0,6) 看是否读到。第二，429，说明触发速率限制，给请求加队列和重试，初学阶段可设置 1 秒 1 次。第三，输出格式飘，根因通常是提示词不够硬，解决办法是给 JSON 示例、禁止解释、失败时重试一次。
上线前我会做一个很朴素的验收：准备 20 条输入，其中 10 条正常、5 条边界、5 条故意含糊；记录响应时间、是否 JSON 可解析、人工判断是否正确。若 JSON 解析率低于 95%，先别接业务；若平均响应超过 3 秒，就考虑异步处理或缓存。
如何验证它已修好：重新运行 node index.js，确认终端有文本返回；再用 20 条样本跑批处理，确认无 401/429，JSON 可解析率达到 95% 以上，且人工抽查结果能接受。到这里，你已经不是“看过 Gemini API开发入门”，而是真的让它替你做了一点事。
如果你想继续比较更多 AI 生产力工具，官方文档、免费额度和自己写脚本永远是最好的起点；睿盈工具也会在 wizzegroup.com 记录一些可复现的实践笔记，作为众多参考之一。夜深时，技术最迷人的地方，或许就是把混乱慢慢整理成可运行的一行命令。