# Gemini 3.6 Flash 与 3.5 Flash-Lite 新特性

Gemini 3.6 Flash (`gemini-3.6-flash`) 和 Gemini 3.5 Flash-Lite (`gemini-3.5-flash-lite`）是 Gemini 3 系列的上一代版本，并且仍然可用于生产使用。对于我们最新的 Flash 模型，请参阅 [Gemini 3.8 Flash](/docs/whats-new-gemini-3.8).

* **Gemini 3.6 Flash**：在复杂的智能体和多模态任务上具有更强的性能，同时减少 token 的使用，价格比 3.5 Flash更低。
* **Gemini 3.5 Flash-Lite**：3.5 系列中速度最快、成本最低的型号。在高吞吐量执行方面优于前几代 Flash-Lite。

本指南解释了每个模型中引入的内容、API 的哪些更改会影响您的代码以及如何迁移。

{% callout type="note" %}
您可以使用支持的编码智能体自动执行此迁移 [技能](/docs/coding-agents#gemini-api-dev) （如 Antigravity）。
{% /callout %}

{% tabs %}
{% tab title="Gemini 3.6 Flash" %}
1. 安装技能：

```bash
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global
```

2. 应用技能：

```bash
/gemini-interactions-api migrate my app to Gemini 3.6 Flash
```
{% /tab %}

{% tab title="Gemini 3.5 Flash-Lite" %}
1. 安装技能：

```bash
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global
```

2. 应用技能：

```bash
/gemini-interactions-api migrate my app to Gemini 3.5 Flash-Lite
```
{% /tab %}
{% /tabs %}

## 新型号  {% #new-models %}

| 模型                    | 型号编号                    | 默认思维水平    | 价格                                    | 说明                           |
| --------------------- | ----------------------- | --------- | ------------------------------------- | ---------------------------- |
| Gemini 3.6 Flash      | `gemini-3.6-flash`      | `medium`  | $1.50/1M 输入 token 和 $7.50/1M 输出 token | 在智能体和多模态任务中平衡速度与智能。          |
| Gemini 3.5 Flash-Lite | `gemini-3.5-flash-lite` | `minimal` | $0.30/1M 输入 token 和 $2.50/1M 输出 token | 速度最快、成本最低的 3.5 型号，可实现高吞吐量执行。 |

两种型号均支持 1M token 上下文窗口、64k 最大输出 token、思维以及全套内置工具，包括 [电脑使用](/docs/computer-use).

有关完整规格，请参阅型号页面：

* [Gemini 3.6 Flash 型号页面](/docs/models/gemini-3.6-flash)
* [Gemini 3.5 Flash-Lite 型号页面](/docs/models/gemini-3.5-flash-lite)

详细定价请参见 [定价页面](/docs/pricing).

## 快速入门  {% #quickstart %}

{% tabs %}
{% tab label="Python" %}
```python
from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.6-flash",
    input="Write a three.js script that renders an interactive 3D robot."
)

print(interaction.output_text)
```
{% /tab %}

{% tab label="JavaScript" %}
```javascript
import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.6-flash",
    input: "Write a three.js script that renders an interactive 3D robot.",
  });
  console.log(interaction.output_text);
}

await main();
```
{% /tab %}

{% tab label="REST" %}
```bash
curl "https://generativelanguage.googleapis.com/v1beta/interactions"   -H "x-goog-api-key: $GEMINI_API_KEY"   -H 'Content-Type: application/json'   -X POST   -d '{
    "model": "gemini-3.6-flash",
    "input": {
      "parts": [{"text": "Write a three.js script that renders an interactive 3D robot."}]
    }
  }'
```
{% /tab %}
{% /tabs %}

## Gemini 3.6 Flash 的新增功能  {% #whats-new-gemini-3-6-flash %}

* **token和回合减少：** 与 Gemini 3.5. 相比，以更少的推理步骤、对话轮次和工具调用完成多步骤工作流。它还减少了执行循环螺旋。
* **改进的代码生成：** 生成更高质量的生产就绪代码，减少不必要的编辑和调试循环。
* **更好地遵循指导**：减少诊断任务期间不需要的文件更改。
* **强大的多模态和空间推理：** 改进了图表解释、视觉蓝图转换和多元素 Web 布局生成的性能。
* **预先程序化检查：** 与 Gemini 3.5 Flash 相比，更喜欢在进行更改之前更频繁地运行诊断代码脚本。这提高了复杂任务的准确性，但可以在日常前端工作中添加额外的探索步骤。
* **计算机使用支持：** 作为智能体 UI 自动化的内置工具提供支持。
* **UI 样式偏好**：更擅长创建功能代码，尽管人类评估者更喜欢早期的视觉布局和样式模型。您可以通过提供明确的设计指南来缓解这种情况。
* **默认思维努力（中）：** 用途相同 `medium` 默认思维级别为Gemini 3.5 Flash。
* **降低价格**：较低的输出 token 成本（$7.50/1M 与 $9.00/1M 对于 3.5 Flash）。输入 token 保留在 $1.50/1M。

## Gemini 3.5 Flash-Lite 的新增功能  {% #whats-new-gemini-3-5-flash-lite %}

* **减少任务执行延迟：** 3.5 系列中吞吐量最高，适用于大容量数据解析和文档提取。
* **增强推理和多模态性能：** 从 Gemini 2.5 Flash 开始的强大迁移路径，在 HLE（18.0% 与 11.0%）等推理任务和 CharXIV（74.5% 与 63.7%）等多模态基准测试上得分更高。
* **子智能体编排和工具可靠性：** 提高了代码执行、搜索和 MCP 工作流程的工具执行可靠性。提高自主规划和复杂子智能体任务的思维水平。
* **提高文档理解：** 提高文档解析和结构化数据提取的准确性。根据文档的复杂性，尝试最低和最高的思维水平。
* **交互式网络编码和表格数据处理：** 通过使用轻量级代码执行进行规划，在前端 JavaScript 和表格数据处理方面表现出色。
* **聊天机器人和角色持久性：** 比 Gemini 3.1 Flash-Lite 更强的多轮指令跟随和角色一致性。
* **计算机使用支持：** 作为智能体 UI 自动化的内置工具提供支持。

## 选择正确的 Flash 或 Flash-Lite 型号  {% #choosing-the-right-flash-model %}

使用此表为您的工作负载选择正确的模型和迁移路径。

两种模型都需要删除已弃用的采样参数（`temperature`, `top_p`, `top_k`）和预填充模型转弯。看 [API 变化](/docs/whats-new-gemini-3.6#api-changes-and-parameter-updates) 了解详情。

| 模型                                                  | 主要用例                              | 推荐迁移目标                                                              |
| --------------------------------------------------- | --------------------------------- | ------------------------------------------------------------------- |
| **Gemini 3.6 Flash** (`gemini-3.6-flash`)           | 代码生成、空间/多模态推理、多步骤智能体工作流程          | **Gemini 3.5 Flash**, **Gemini 3 Flash（预览版）**, 或 **Gemini 3.1 Pro** |
| **Gemini 3.5 Flash-Lite** (`gemini-3.5-flash-lite`) | 自主子智能体执行、大容量数据分析和文档提取、结构化 JSON 解析 | **Gemini 3.1 Flash-Lite** 或 **Gemini 2.5 Flash**                    |

## Antigravity 智能体支持  {% #updated-antigravity-agent %}

Gemini 3.6 Flash 引入了对 [Antigravity 智能体](/docs/antigravity-agent) 在 Gemini 托管智能体中。

有关当前代码示例和最新的默认智能体配置，请参阅 [Antigravity 智能体指南](/docs/antigravity-agent) 和 [Gemini 3.8 Flash指南](/docs/whats-new-gemini-3.8#updated-antigravity-agent).

## API变更及参数更新  {% #api-changes-and-parameter-updates %}

从 Gemini 3.6 Flash 和 Gemini 3.5 Flash-Lite 开始，以下 API 更改适用于这些型号以及所有未来的 Gemini 型号版本。

* **采样参数弃用**: `temperature`, `top_p`, 和 `top_k` 已弃用。 API 会忽略这些参数并在未来的模型生成中返回错误。
* **预填充模型轮验证**：不再支持预填充模型转弯。如果请求中的最后一个非空回合是 `model` 反过来，API 返回一个 `400` 错误。

以下部分提供每个 API 更改的详细说明和代码示例。

### 1. 采样参数弃用（温度、top_p、top_k）  {% #sampling-parameter-deprecation %}

`temperature`, `top_p`, 和 `top_k` 已被弃用并被忽略。在未来的模型中，提供这些参数会返回 HTTP 400 错误。 **从所有请求中删除这些参数。**

```python
# ⚠️ Remove these parameters (deprecated)
generation_config = {
     "temperature": 0.7,
     "top_p": 0.9,
     "top_k": 40,
}
```

为了提高确定性，请为您的特定用例定义具有明确规则的系统指令。

### 2. 预填充模型转向验证  {% #prefilled-model-turn-validation %}

以非空模型角色回合结束的 API 请求将被禁止并返回 **HTTP 400 错误**.

#### ⚠️避免  {% #prefill-avoid %}

遗产中 `generateContent` 现在不允许以模型角色转变结束的原始 REST 有效负载：

```json
/* ❌ DO NOT: End payload contents with a 'model' role turn */
{
  "contents": [
    {"role": "user", "parts": [{"text": "Translate 'Hello world' to Spanish."}]},
    {"role": "model", "parts": [{"text": "Translation:"}]}  /* ❌ Returns error */
  ]
}
```

#### ✅ 推荐迁移（Interactions API）  {% #prefill-recommended-migration %}

在 Interactions API 中，模型转弯不是手动预填充的。如果您的应用程序之前预填充模型转向抑制前导码或强制 JSON 格式，请使用 system_instruction 或 [结构化输出](/docs/structured-output) 相反。

```python
# ✅ RECOMMENDED: Use system_instruction in the Interactions API to specify output format
interaction = client.interactions.create(
    model="gemini-3.6-flash",
    input="Translate 'Hello world' to Spanish.",
    system_instruction="Output only the translation without introductory text.",
)
```

## 迁移清单  {% #migration-checklist %}

{% callout type="note" %}
您可以使用支持的编码智能体自动执行此迁移 [技能](/docs/coding-agents#gemini-api-dev) （如 Antigravity）。
{% /callout %}

{% tabs %}
{% tab title="Gemini 3.6 Flash" %}
1. 安装技能：

```bash
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global
```

2. 应用技能：

```bash
/gemini-interactions-api migrate my app to Gemini 3.6 Flash
```
{% /tab %}

{% tab title="Gemini 3.5 Flash-Lite" %}
1. 安装技能：

```bash
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global
```

2. 应用技能：

```bash
/gemini-interactions-api migrate my app to Gemini 3.5 Flash-Lite
```
{% /tab %}
{% /tabs %}

### 迁移到 gemini-3.6-flash  {% #migrate-to-gemini-3-6-flash %}

* **更新型号 ID：** Change your target model string to `gemini-3.6-flash`.

* **应用参数更新：** 删除已弃用的采样参数（`temperature`, `top_p`, `top_k`), `candidate_count` （Gemini 3 及更高版本中不支持），以及预填充模型转弯，详细信息请参见 [API变更及参数更新](/docs/whats-new-gemini-3.6#api-changes-and-parameter-updates).

* **配置思维层次：** 更换 `thinking_budget` 使用 `thinking_level` (`"medium"` 或 `"high"`).

* **审核函数调用：**  * 将多模态资产放入响应负载中。

  * 使用格式化内联指令 `\n\n`.
  * 如果你看到 `Malformed_Function_Call` 与工具前文本相关的错误，请参阅 [工具前文本要求的解决方法](/docs/function-calling#workarounds-for-pre-tool-text-requirements).

* **基线 Gemini 3.x 要求：** 有关 SDK 更新和思想签名保存，请参阅 [思考签名](/docs/thinking#signatures).

### 迁移到 gemini-3.5-flash-lite  {% #migrate-to-gemini-3-5-flash-lite %}

* **更新型号 ID：** Change your target model string to `gemini-3.5-flash-lite`.

* **配置思考努力水平：**  * 对于大容量提取、路由或分类：保留 `thinking_level` 在 `"minimal"` （默认）以获得最大吞吐量。

  * 对于具有工具调用、代码执行或多步推理的自治子智能体：设置 `thinking_level` 到 `"medium"` 或 `"high"` 以防止工具过早终止。

* **删除已弃用的参数并验证函数调用：** 应用 [与3.6 Flash相同的规则](/docs/whats-new-gemini-3.6#migrate-to-gemini-3-6-flash).

* **基线 Gemini 3.x 要求：** 参考 [思考签名](/docs/thinking#signatures).

## 其他型号  {% #other-models %}

* [最新 Gemini 模型](/docs/latest-model)
* [Gemini 4 Hydrogen](/docs/whats-new-gemini-4-hydrogen)
* [Gemini 4 Carbon](/docs/whats-new-gemini-4-carbon)
* [Gemini 4 Argon](/docs/whats-new-gemini-4-argon)
* [Gemini 3.8 Flash](/docs/whats-new-gemini-3.8)
* [查看所有型号](/docs/models)

## 后续步骤  {% #whats-next %}

* 查看 API 规格 [型号概览](/docs/models).
* 探索多智能体编排 [Interactions API指南](/docs/interactions-overview).
* 测试并完善提示 [Google AI Studio](https://aistudio.google.com/).
