Gemini 3.7 Flash 刚上线，新人怎么第一天就跑通它

我花了两天试了一下 Gemini 3.7 Flash，谷歌前天刚发的这个新模型，主打编程和智能体。先说结论：如果你之前用过 3.6 Flash，这次升级体验很直接，而且价格打对折，值得换。

背景先说一下。Gemini Flash 是谷歌的轻量模型系列，特点是快、便宜，适合高频调用。这次 3.7 Flash 跟 3.6 只隔了三周，谷歌说主要吸收了开发者反馈。我这边测下来，代码能力确实有提升。据谷歌公开的测评数据，在 DeepSWE v1.1 这个软件工程基准上，得分从 49% 直接跳到 65.3%。这类基准就是给模型一堆真实的 GitHub 仓库任务，看它能不能自己把代码改对、跑通。涨了 16 个百分点，幅度不算小。

下面是完整的新手流程，从零开始说。

前提：你有一个 Google 账号，浏览器用 Chrome 或 Edge，然后记得能访问 Google 服务。这一步卡住的话，后面什么都做不了。

第一步，拿到 API key。 API key 可以理解成一张门禁卡，你的程序拿它才能叫得动模型。

打开 aistudio.google.com，用 Google 账号登录。进去之后看左侧栏，找 Get API key 或者 API keys 这个入口，点进去，点 Create API key，会弹出一个列表让你选项目，选默认那个或者新建一个都行。生成之后，那串以 AIza 开头的字符就是你的 key。复制下来，先贴到记事本里，后面要用。

第二步，确认模型可选。 在 AI Studio 界面左上角有一个模型下拉框，点开之后找 gemini-3.7-flash 这个名字。有些账号可能显示 gemini-3.7-flash-preview，说明是预览版，问题不大。

如果没看到，两个可能：账号还没被灰度到，或者界面缓存太久。清一下浏览器缓存，重新打开再看。我这边测的时候，一开始就只显示 3.6，清了缓存之后 3.7 就出来了。

第三步，安装官方 SDK。 SDK 就是官方封装好的代码库，省得你从零写调用逻辑。

打开终端（macOS 叫终端，Windows 叫命令提示符或 PowerShell），输入以下命令，回车：

pip install google-genai

看到 Successfully installed 之类的字样就说明装好了。

第四步，写第一段调用代码。 新建一个文本文件，命名为 test_gemini.py，把下面内容粘进去。用记事本或者 VS Code 都可以：

from google import genai

client = genai.Client(api_key="你的API key粘贴到这里")
response = client.models.generate_content(
    model="gemini-3.7-flash",
    contents="写一个Python函数，判断一个数是不是素数",
)
print(response.text)

保存之后，在终端里进入该文件所在的目录，运行：

python test_gemini.py

看到输出一段 Python 代码，说明你成功调用了 3.7 Flash。整个过程大概五分钟。

踩坑环节，我这两天遇到三个坑。

第一个坑，模型名写错。SDK 里要用 gemini-3.7-flash，我看到有人写 gemini-3.7-flash-latest，直接报 404。以官方文档为准，别凭记忆猜名字。

第二个坑，Quota 超限。刚发布的模型最容易出这个问题，报错写的是 429 RESOURCE_EXHAUSTED，意思是免费配额满了。这不是你代码的问题，是太多人同时在用。我周四晚上试的时候连续报了三次，等到周五早上就通了。着急的话去 console.cloud.google.com 看配额，申请提额，不过个人账号大概率被拒。

第三个坑，Chrome 报错。AI Studio 页面对浏览器版本有要求，我同事用旧版 Chrome 打开，页面直接白屏。升级浏览器到最新版基本能解决。

然后说优缺点。 按我这两天的实际体验。

优点有三个。便宜。首发优惠价是原来是 3.6 Flash 的一半，这对个人开发者是真友好，我这种拿自己账号调接口跑实验的，成本直接砍半。编程能力提升明显，尤其调试多步任务的时候，比 3.6 少了很多来回。迭代快，谷歌三周就出一版，说明开发者反馈是真的在被消化。

缺点也有三个。刚发布不稳定，Quota 动不动就满，高峰期基本挤不进去。跟 3.6 间隔太短，社区还没来得及沉淀踩坑经验，出了问题只能自己扛。免费额度不多，想跑重活得付费，个人开发者要掂量一下。

谷歌官方说，3.7 Flash 是目前 Flash 系列里最智能的工作型模型，后续相关成果会继续融入旗舰模型。这个说法我认同，看这迭代速度，Flash 系列现在就是谷歌的试验田。

最后给个判断。我的建议是：如果你主要拿模型来写代码、调数据、做自动化，3.7 Flash 值得立刻升级，性能涨了还便宜一半，没有理由守着旧版。如果只是聊天问答、写摘要，那没必要追，3.6 够用，等稳定了再说。

趋势方面，我的预测是：Flash 系列这种高频小步快跑的节奏会持续下去，而且价格会继续往下打。大模型竞争已经从拼参数进入拼单价和场景适配的阶段，谁能把单位成本压到最低，谁就能抢到最多的开发者。谷歌这步棋，走的是量。

学完这个教程，下一步可以试着用 3.7 Flash 跑一个稍微完整的智能体流程，比如让它自己读一个本地文件、提取关键信息、然后按你的要求格式化输出。跑通了，你就大概知道 Agents 场景是怎么回事了。