# Gemini 3.8 Flash API 指南：型号、价格、规格与迁移

> Gemini 3.8 Flash 已正式发布，3.7 Flash 的请求自 10 月 8 日起自动转到它。了解准确模型 ID、输入输出上限、工具支持与 2027 年价格变化，完成首次 API 请求。

- Source: https://www.aifreeapi.com/zh/posts/gemini-3-8-flash
- Language: zh
- Published: 2026-09-02
- Updated: 2026-10-10
- Publisher: AI Free API (https://www.aifreeapi.com)

Google 已在 **2026 年 9 月 2 日**正式发布 Gemini 3.8 Flash，进入正式可用（GA）阶段，准确的 Gemini Developer API 型号是 `gemini-3.8-flash`。Google 将它定位为面向长周期软件工程、自主代理与复杂企业工作流的最强 Flash 模型。[Google 发布记录](https://ai.google.dev/gemini-api/docs/changelog)

2026 年 10 月 8 日起，Google 已弃用 Gemini 3.7 Flash，所有发给 `gemini-3.7-flash` 的请求都会自动转到 `gemini-3.8-flash`（[发布说明](https://ai.google.dev/gemini-api/docs/changelog)）。所以 3.8 现在不只是值得评估的新型号：代码里还写着 3.7 的系统，实际已经由 3.8 处理请求。3.8 在 2026 年底前使用标准促销价，2027 年 1 月 1 日起价格翻倍；是否把更多任务交给它，仍要看自己的任务成功率、延迟、token 与每个成功任务成本。

## Gemini 3.8 Flash 官方规格

[官方型号页](https://ai.google.dev/gemini-api/docs/models/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 搜索和地图信息检索、网页内容读取，以及仍处于预览阶段的计算机操作功能。具体支持范围见[官方模型页](https://ai.google.dev/gemini-api/docs/models/gemini-3.8-flash)。

三个限制会直接影响实现：

- `minimal` 思考级别不受支持，会返回错误；只能使用 `low`、`medium` 或 `high`。
- 不支持图片生成和音频生成。
- 不支持 Live API。

工具支持也不等于所有功能按同一单位收费。搜索和地图检索、缓存存储、计算机操作及不同调用模式各有独立条件，接入时要按真实使用组合核算。

## Gemini 3.8 Flash 价格

[Google 官方价格页](https://ai.google.dev/gemini-api/docs/pricing)以美元/每百万 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、按小时计算的存储，以及搜索和地图检索也有单独规则。只看输入单价会低估真实账单：

`每个成功任务成本 = 本批任务的输入、输出（含思考）、工具及缓存等实际总费用 ÷ 成功完成的任务数`

总费用应包含失败尝试和重试产生的收费；成功任务数为零时，不能计算一个正常均价。

![Gemini 3.8 Flash 中文规格与迁移总览（2026 年 9 月版），包含 model ID、上下文、价格、工具、限制和当时的 3.7 对照评测流程；3.7 的请求现已转到 3.8](https://www.aifreeapi.com/posts/zh/gemini-3-8-flash/img/specs-and-migration.webp)

3.8 如果能减少重试或一次完成复杂工具链，实际可能更省；如果任务本来不需要它，输出变长也可能增加成本。

## 发出第一个请求

Google 当前的[文本生成指南](https://ai.google.dev/gemini-api/docs/text-generation)使用 Interactions API。先安装最新 `google-genai` SDK，将 Gemini API 密钥设为环境变量 `GEMINI_API_KEY`。下面用一条无需额外附件的请求检查文本返回；代码按文档编写，未作付费调用实测。

```bash
python -m pip install --upgrade google-genai
```

Python 示例：

```python
from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="列出部署一个静态网站前应检查的三个失败条件。",
)

print(interaction.output_text)
```

REST 请求：

```bash
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 发布说明](https://ai.google.dev/gemini-api/docs/changelog)把 `gemini-3.7-flash` 列为弃用，并写明所有发给它的请求自动转到 `gemini-3.8-flash`；[退役时间表](https://ai.google.dev/gemini-api/docs/deprecations)上暂无关闭日期，价格页也不再列出 3.7 Flash。还在调用 3.7 的系统不会报错，但处理请求的已经是 3.8。

剩下要做的是三件事：

1. **把 model ID 改成 `gemini-3.8-flash`**。Google 在发布说明里要求更新模型字符串；继续依赖自动转发，配置和日志里写的型号与实际处理请求的模型不一致，排查问题时容易误判。原来对 3.7 设置的 `low`、`medium`、`high` 思考级别在 3.8 上仍可用。
2. **用旧日志做对照，重跑固定样本**。3.7 已经无法和 3.8 并行调用，对照基线只能是 10 月 8 日前在 3.7 上记录的结果。提示词、工具、思考级别、超时时间和合格标准保持不变，覆盖正常请求、长上下文、结构化输出、工具失败、安全拒绝与多轮状态；记录首次成功率、工具调用正确率、延迟的中位数和第 95 百分位数（P50/P95）、输入输出 token、重试、拒绝请求及每个成功任务成本。
3. **核对账单**。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 日发布时，[更新日志](https://ai.google.dev/gemini-api/docs/changelog)把 3.8 列为 GA，并称它是当前最智能的 Flash。这是 Google 的产品定位，不是你私有任务上的独立结论，所以上面的回归测试仍然要做。

![2026 年 9 月版 Gemini 3.8 Flash 中文迁移评测流程，展示任务集、固定配置、运行与指标记录、完整响应处理和生产接入架构；图中与 3.7 并行运行的步骤现在改为对照 3.7 旧日志](https://www.aifreeapi.com/posts/zh/gemini-3-8-flash/img/migration-evaluation-and-response.webp)

如果你还需要在 Flash-Lite、Flash 和 Pro 之间做更宽的选择，可以查看独立的 [Gemini 文本模型指南](/zh/posts/gemini-3-0-api)。

## 结论

`gemini-3.8-flash` 现在已经是可调用的稳定型号。它最值得测试的场景是长周期软件工程、自主代理、复杂工具使用和大上下文任务。还在调用 `gemini-3.7-flash` 的系统，请求已经由 3.8 处理，应尽快改成新 ID 并重测。2026 年的促销价具有吸引力，但必须把官方公布的 2027 年涨价纳入预算，并用自己的任务证明 3.8 适合承担更多工作。