Gemini 3.8 Flash 有哪些新功能

查看所有模型

Gemini 3.8 Flash (gemini-3.8-flash) 现已正式发布 (GA)，可用于生产环境。它是我们最智能的 Flash 模型，专为长期软件工程、自主智能体和复杂的企业工作流而设计。

本指南介绍了 Gemini 3.8 Flash 的新增功能、API 变更、代码示例和迁移指南。

新建模型

模型 模型 ID 默认思考级别 价格 说明
Gemini 3.8 Flash gemini-3.8-flash medium 3.8 Flash 将以初次体验价提供至今年年底，每百万输入 token 仅需 0.75 美元，每百万输出 token 仅需 3.75 美元；如需了解详情，请参阅价格。 我们最智能的 Flash 模型，专为长期软件工程、自主智能体和复杂的企业工作流而设计。

Gemini 3.8 Flash 支持 100 万个 token 的上下文窗口、最多 6.4 万个输出 token、可调的思考级别（low、medium、high）以及相同的内置工具套件。

如需了解完整规格，请参阅Gemini 3.8 Flash 模型页面。如需了解初次体验价的详细信息，请参阅下方的价格部分或价格页面。

快速入门

Python

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-3.8-flash",
    contents="Write a three.js script that renders a realistic 3D black hole."
)

print(response.text)

JavaScript

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: "gemini-3.8-flash",
  contents: "Write a three.js script that renders a realistic 3D black hole.",
});

console.log(response.text);

REST

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [{"text": "Write a three.js script that renders a realistic 3D black hole."}]
    }]
  }'

Gemini 3.8 Flash 的新增功能

  • 长期软件工程： 在真实世界编码基准、复杂的多文件重构和确定性工具执行方面表现出色。如需了解详情，请参阅评估方法。
  • 自主智能体： 可让您构建弹性多步规划和工具编排工作流，大幅减少失败的循环和错误。
  • 复杂的企业工作流： 在要求严苛的领域任务和大规模数据流水线中，可提供卓越的准确性、深入的推理能力和高度的事实严谨性。
  • 托管式智能体的默认模型： 托管式智能体的默认智能体 Antigravity 智能体现在使用 Gemini 3.8 Flash。Antigravity SDK 也默认使用 Gemini 3.8 Flash。
  • 初次体验价： Gemini 3.8 Flash 将以初次体验价提供至 2026 年 12 月 31 日，每百万输入 token 仅需 0.75 美元，每百万输出 token 仅需 3.75 美元。标准价格为每百万输入 token 1.50 美元，每百万输出 token 7.50 美元，将于 2027 年 1 月 1 日生效。

根据设计，Gemini 3.8 Flash 可以在运行时间较长且复杂的任务中使用更多 token。为了在困难的多步目标上提供更高质量的结果，该模型会采取较小的推理步骤，迭代调用工具，并在此过程中验证其工作。并非每个工作流都需要这种级别的验证。对于日常任务，您可以降低推理工作量，以减少 token 消耗。或者，Gemini 3.7 Flash 仍完全受支持。

了解推理级别

Gemini 3.8 Flash 可让您通过调整模型的思考级别来灵活控制延迟时间和智能：

  • 低思考力度：缩短延迟时间关键型任务的回答时间，例如突发事件响应流水线、实时聊天、撰写草稿和快速数据分析。
  • 中等（默认）： 适用于大多数任务的最佳质量。建议用于复杂的代码和智能体用例，可提供更高的首次准确率。
  • 思考力度：最大限度地提高模型的推理和工具编排能力。最适合深度推理、数学和困难的多步任务。

以下示例将 thinking_level 设置为 medium，用于复杂的代码分析请求：

Python

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="gemini-3.8-flash",
    contents="Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
    config=types.GenerateContentConfig(
        thinking_config=types.ThinkingConfig(
            thinking_level="medium"  # Balanced reasoning effort for complex tasks
        ),
    ),
)

print(response.text)

JavaScript

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: "gemini-3.8-flash",
  contents: "Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
  config: {
    thinkingConfig: {
      thinkingLevel: "medium", // Balanced reasoning effort for complex tasks
    },
  },
});

console.log(response.text);

REST

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [{"text": "Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely."}]
    }],
    "generationConfig": {
      "thinkingConfig": {
        "thinkingLevel": "medium"
      }
    }
  }'

更新后的 Antigravity 智能体

迁移核对清单

  `/gemini-api-dev migrate my app to Gemini 3.8 Flash`

迁移到 gemini-3.8-flash

  • 更新模型 ID： 将目标模型字符串更改为 gemini-3.8-flash。
  • 移除已废弃的采样参数：
    • 从生成配置中移除 temperature、top_p 和 top_k。
    • 将 thinking_budget 替换为字符串枚举 thinking_level。请注意，3.8 Flash 不支持 minimal。
    • 移除 candidate_count（Gemini 3 及更高版本不支持）。
  • 强制执行轮次验证规则：
    • 移除预填充的模型轮次。
    • 确保最终用户轮次包含非空文本。
  • 审核函数调用：
    • 将多模态素材资源放置在响应载荷内。
    • 使用 \n\n 设置内嵌说明的格式。
    • 如果您看到与工具前文本相关的 Malformed_Function_Call 错误，请参阅 工具前文本要求的变通方法。
    • 仅在使用 generateContent API 时：确保所有 FunctionResponse 对象都包含 call_id 和 name。
  • Gemini 3 基准要求： 如需了解 SDK 更新和思考签名保留，请参阅Gemini 3.5 迁移核对清单。

价格

在 2026 年 12 月 31 日之前，Gemini 3.8 Flash、Gemini 3.7 Flash 和 Gemini 3.6 Flash 可在 Google AI Studio 和 Gemini Enterprise Agent Platform 中享受初次体验价。标准价格将于 2027 年 1 月 1 日生效。如需了解完整价格层级，请参阅价格页面。

后续步骤