前阵子帮人排查 Gemini API 报错，代码翻来覆去看不出毛病，最后病灶落在教程上，他照搬的是某篇博客，里面的模型名和参数早就废弃了。二手教程的通病就在这里：写的人发完就撤，没人管后续。真要学 Gemini API，最稳的路径是 Google 官方的 Cookbook 仓库 github.com/google-gemini/cookbook：49 个快速上手教程，外加一摞组合实战示例，全部做成 Colab 里能直接跑的 notebook，分文不取。可惜这仓库在国内知名度不高，就亏在没人推。

这库还有一处值钱的地方：整库刚统一切到 Gemini 3.7 Flash 当默认模型，教程始终咬着当前版本走。学 API 最怕的就是教程与实际版本脱节，这一点比什么都金贵。

起步只要两样东西

一个 Google 账号，配一把在 Google AI Studio 里创建的 API Key（aistudio.google.com/app/apikey）。学习场景下的免费额度相当宽裕，照着教程走基本撞不上墙。

49 本教程的正确打开方式：按方向分流

官方给的路线是先跑 Authentication（认证）和 Get Started（入门总览），把调用方式打通，再按兴趣分岔。文本方向看 Generate Content、System Instructions 和 Prompting 三本。多模态方向，Nano-Banana 那本讲图像生成与多轮对话式编辑，Omni Flash 管视频生成，Lyria 3 管音乐生成，都是近期新增的热门货。做 Agent 的话，Function Calling，托管 Agent（Antigravity），Deep Research 三个入口任选。

地基打牢后直奔 examples 目录，那里收着组合多种能力的完整应用：拿浏览器当工具用，给整本书配插图，3D 空间理解，当项目灵感库再合适不过。

三本被埋没的好教程

单独拎三本出来点名。OpenAI Compatibility 教你拿 OpenAI SDK 直接调 Gemini，老项目迁移时用得上。JSON Mode 讲结构化输出，做数据抽取的必看。Grounding 覆盖 Google 搜索，地图，YouTube 多种接地方式，压幻觉的效果显著。另外仓库还备了 quickstarts-js 目录，JavaScript 版快速入门一应俱全，前端同学不必死磕 Python。

节奏上给个参照：第一周跑通认证外加三本基础教程，第二周按应用方向挑四五本专题，第三周动手改 examples 里的完整示例。按这个走法，一个月内从零基础做到能用的东西，绰绰有余。搭配站内教程一起看，效果更佳。