Google 已在 2026 年 9 月 2 日正式发布 Gemini 3.8 Flash，进入正式可用（GA）阶段，准确的 Gemini Developer API 型号是 gemini-3.8-flash。Google 将它定位为面向长周期软件工程、自主代理与复杂企业工作流的最强 Flash 模型。Google 发布记录
2026 年 10 月 8 日起，Google 已弃用 Gemini 3.7 Flash，所有发给 gemini-3.7-flash 的请求都会自动转到 gemini-3.8-flash（发布说明）。所以 3.8 现在不只是值得评估的新型号：代码里还写着 3.7 的系统，实际已经由 3.8 处理请求。3.8 在 2026 年底前使用标准促销价，2027 年 1 月 1 日起价格翻倍；是否把更多任务交给它，仍要看自己的任务成功率、延迟、token 与每个成功任务成本。
Gemini 3.8 Flash 官方规格
官方型号页列出的规格如下：
| 项目 | Gemini 3.8 Flash |
|---|---|
| 模型 ID | gemini-3.8-flash |
| 状态 | Stable / GA |
| 输入 | 文本、图片、视频、音频、PDF |
| 输出 | 文本 |
| 输入上限 | 1,048,576 token |
| 输出上限 | 65,536 token |
| 思考级别 | low、medium、high |
| 调用模式 | Standard、Batch、Flex、Priority |
“可接收图片、视频和音频”表示理解能力，不表示可以生成这些媒体。Gemini 3.8 Flash 不支持图片生成、音频生成和 Live API；需要这些输出时，应使用对应的专用模型。
支持的工具与容易踩错的边界
3.8 Flash 支持上下文缓存、代码执行、文件搜索、函数调用、结构化输出、Google 搜索和地图信息检索、网页内容读取，以及仍处于预览阶段的计算机操作功能。具体支持范围见官方模型页。
三个限制会直接影响实现：
minimal思考级别不受支持，会返回错误；只能使用low、medium或high。- 不支持图片生成和音频生成。
- 不支持 Live API。
工具支持也不等于所有功能按同一单位收费。搜索和地图检索、缓存存储、计算机操作及不同调用模式各有独立条件，接入时要按真实使用组合核算。
Gemini 3.8 Flash 价格
Google 官方价格页以美元/每百万 token 计价，输出价格包含思考 token。
| 模式 | 2026 年底前输入 | 2026 年底前输出 | 2027 年起输入 | 2027 年起输出 |
|---|---|---|---|---|
| Standard | $0.75 | $3.75 | $1.50 | $7.50 |
| Batch | $0.375 | $1.875 | $0.75 | $3.75 |
| Flex | $0.375 | $1.875 | $0.75 | $3.75 |
| Priority | $1.35 | $6.75 | $2.70 | $13.50 |
Standard 与 Priority 当前显示免费层，Batch 和 Flex 不显示。缓存 token、按小时计算的存储，以及搜索和地图检索也有单独规则。只看输入单价会低估真实账单：
每个成功任务成本 = 本批任务的输入、输出（含思考）、工具及缓存等实际总费用 ÷ 成功完成的任务数
总费用应包含失败尝试和重试产生的收费；成功任务数为零时，不能计算一个正常均价。
3.8 如果能减少重试或一次完成复杂工具链，实际可能更省；如果任务本来不需要它，输出变长也可能增加成本。
发出第一个请求
Google 当前的文本生成指南使用 Interactions API。先安装最新 google-genai SDK，将 Gemini API 密钥设为环境变量 GEMINI_API_KEY。下面用一条无需额外附件的请求检查文本返回；代码按文档编写，未作付费调用实测。
python -m pip install --upgrade google-genaiPython 示例：
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.8-flash",
input="列出部署一个静态网站前应检查的三个失败条件。",
)
print(interaction.output_text)REST 请求：
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.8-flash",
"input": "列出部署一个静态网站前应检查的三个失败条件。"
}'第一次请求可先沿用默认思考设置。需要严格比较延迟与成本时，再明确设置 thinking_level，并让新旧模型使用相同配置。若响应还包含思考、工具步骤或其他内容块，不要只依赖便利的文本字段，应按完整响应结构读取。
要不要从 Gemini 3.7 Flash 迁移
已经不用选了。2026 年 10 月 8 日，Gemini API 发布说明把 gemini-3.7-flash 列为弃用，并写明所有发给它的请求自动转到 gemini-3.8-flash；退役时间表上暂无关闭日期，价格页也不再列出 3.7 Flash。还在调用 3.7 的系统不会报错，但处理请求的已经是 3.8。
剩下要做的是三件事：
- 把 model ID 改成
gemini-3.8-flash。Google 在发布说明里要求更新模型字符串；继续依赖自动转发，配置和日志里写的型号与实际处理请求的模型不一致，排查问题时容易误判。原来对 3.7 设置的low、medium、high思考级别在 3.8 上仍可用。 - 用旧日志做对照，重跑固定样本。3.7 已经无法和 3.8 并行调用，对照基线只能是 10 月 8 日前在 3.7 上记录的结果。提示词、工具、思考级别、超时时间和合格标准保持不变，覆盖正常请求、长上下文、结构化输出、工具失败、安全拒绝与多轮状态；记录首次成功率、工具调用正确率、延迟的中位数和第 95 百分位数（P50/P95）、输入输出 token、重试、拒绝请求及每个成功任务成本。
- 核对账单。Google 没有说明转发请求按哪个型号计价。按实际处理请求的 3.8 Flash 计价是推测，不是官方说法，以 Cloud Billing 报表里按 SKU 列出的费用为准；3.7 弃用前与 3.8 在 2026 年内的标准价都是 $0.75 / $3.75。
如果 3.8 在某类任务上出现回归，能回退的稳定版是 gemini-3.6-flash，不是 3.7。3.6 Flash 也是 3.5 Flash 弃用后的替代型号，2026 年内与 3.8 同价。
9 月 2 日发布时，更新日志把 3.8 列为 GA，并称它是当前最智能的 Flash。这是 Google 的产品定位，不是你私有任务上的独立结论，所以上面的回归测试仍然要做。
如果你还需要在 Flash-Lite、Flash 和 Pro 之间做更宽的选择，可以查看独立的 Gemini 文本模型指南。
结论
gemini-3.8-flash 现在已经是可调用的稳定型号。它最值得测试的场景是长周期软件工程、自主代理、复杂工具使用和大上下文任务。还在调用 gemini-3.7-flash 的系统，请求已经由 3.8 处理，应尽快改成新 ID 并重测。2026 年的促销价具有吸引力，但必须把官方公布的 2027 年涨价纳入预算，并用自己的任务证明 3.8 适合承担更多工作。
