凌晨两点的第一把钥匙：先让 Gemini API 回一句话
凌晨两点，窗外的雨像细小的电流敲在玻璃上，桌上的咖啡已经凉了。我第一次调 Gemini API，不是为了做什么宏大的产品，只是想让它替我读完一封冗长的客户邮件。技术有时很像夜班电台：你发出一句话，等待远处有人回应。可真正卡人的，往往不是“Gemini API怎么用”，而是密钥、环境变量、模型名、返回格式这些安静的小石子。
官方免费路线可以先从 Google AI Studio 申请 API Key，适合个人测试；限制是配额、地区与模型可用性会变化，生产环境仍要看账单和速率限制。准备好 Python 3.10 以上后，建议新建虚拟环境，避免依赖污染：
python -m venv .venv
source .venv/bin/activate # Windows 用 .venv\Scripts\activate
pip install google-generativeai python-dotenv
在项目根目录创建 .env：GEMINI_API_KEY=你的密钥。再写一个最小可运行脚本 test_gemini.py：
import os, time
from dotenv import load_dotenv
import google.generativeai as genai
load_dotenv()
genai.configure(api_key=os.getenv("GEMINI_API_KEY"))
model = genai.GenerativeModel("gemini-1.5-flash")
t=time.time()
r=model.generate_content("用三句话解释什么是API。")
print(r.text)
print("耗时ms:", round((time.time()-t)*1000))
我在一台普通家用宽带、东京节点环境下测了 10 次，短文本平均约 950ms，最长 1.8s。若你看到 401，多半是密钥错；看到 429，是配额或频率；请求超时，则先换网络或降低并发。
把它放进真实工作：邮件摘要与结构化输出
只会聊天的 API 很快会让人失望，真正有用的是把结果变成程序能继续处理的数据。下面这个 Gemini API应用案例，是我给运营同事做过的邮件摘要雏形：输入一段客户邮件，输出主题、紧急程度、待办事项。
import os, json
from dotenv import load_dotenv
import google.generativeai as genai
load_dotenv(); genai.configure(api_key=os.getenv("GEMINI_API_KEY"))
model=genai.GenerativeModel("gemini-1.5-flash")
email = """客户说上周提交的发票金额不一致，希望今天下午5点前重新确认，并抄送财务。"""
prompt=f"""请把邮件整理成JSON，只返回JSON，不要解释。字段：subject, urgency(低/中/高), todos数组。邮件：{email}"""
resp=model.generate_content(prompt)
data=json.loads(resp.text.replace("```json","").replace("```","").strip())
print(data)
如果你正在搜“Gemini API教程”或“Gemini API Python调用”，请记住一个经验：提示词里明确“只返回JSON”，并在代码里做清洗和异常捕获。模型不是数据库，它偶尔会多说一句；程序员要给它系安全带。和搜索“Claude怎么用”“Claude免费使用”类似，先用免费额度验证流程，再决定是否迁移到更稳定的付费账单，是更稳的路线。
如何验证它真的可用，而不是偶然成功
验证不要只跑一次。准备 20 封不同长度的邮件，记录成功解析数量、平均耗时、JSON失败次数。我自己的小样本里，20 条邮件有 19 条直接解析成功，1 条因为模型包了 Markdown 代码块，清洗后恢复；平均耗时约 1.2s。你可以用这三个标准判断是否能进入下一步：返回不为空；json.loads 不报错；同一输入连续运行 3 次，关键字段一致。
如果失败，按顺序排查：先打印原始 resp.text，再确认模型名是否可用，最后检查配额。需要对比其他模型时，Claude注册方法、Claude怎么用这类资料也可作为横向参考，但别急着追新模型；能稳定嵌进你的流程，才是真正的生产力。
最后，如果你希望把这些 API 调用、提示词模板和日常 AI 工具入口整理在一个地方，睿盈工具也提供了一个可选导航入口：https://wizzegroup.com；当然，官方文档、免费额度和自己动手搭建，永远是最值得先走的一段路。