Gemini 3.8 Flash 的新功能

Gemini 3.8 Flash (gemini-3.8-flash) 現已正式發布，可供正式環境使用。這是我們最聰明的 Flash 模型，適合用於長程軟體工程、自主式代理，以及複雜的企業工作流程。

本指南說明 Gemini 3.8 Flash 的新功能、API 異動、程式碼範例和遷移指南。

新增模型

模型	模型 ID	預設思考程度	定價	說明
Gemini 3.8 Flash	`gemini-3.8-flash`	`medium`	3.8 Flash 將以新用戶優惠推出至年底，每 100 萬個輸入詞元 $0.75 美元，每 100 萬個輸出詞元 $3.75 美元；詳情請參閱定價。	我們最聰明的 Flash 模型，適合用於長程軟體工程、自主式代理，以及複雜的企業工作流程。

Gemini 3.8 Flash 支援 100 萬個詞元的脈絡窗口、最多 6.4 萬個輸出詞元、可調整的思考層級 (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。
優惠價格：2026 年 12 月 31 日前，Gemini 3.8 Flash 的優惠價格為每 100 萬個輸入詞元 $0.75 美元，每 100 萬個輸出詞元 $3.75 美元。自 2027 年 1 月 1 日起，標準定價為每 100 萬個輸入權杖 $1.50 美元，每 100 萬個輸出權杖 $7.50 美元。

根據設計，Gemini 3.8 Flash 可在長時間執行的複雜工作中使用更多權杖。為了針對困難的多步驟目標提供更高品質的結果，模型會採取較小的推論步驟、反覆呼叫工具，並在過程中驗證工作。並非所有工作流程都需要這種程度的驗證。如果是日常工作，您可以降低推論工作量，減少詞元消耗量。或者，您仍可使用 Gemini 3.6 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。
設定思考程度：將 thinking_budget 替換為字串列舉 thinking_level。請注意，Gemini 3.8 Flash 不支援 minimal，請選擇 low、medium (預設) 或 high。
套用 Gemini 3 API 參數變更：移除已淘汰的取樣參數 (temperature、top_p、top_k)、candidate_count (Gemini 3 以上版本不支援)，以及預先填入的模型輪流。請參閱 Gemini 3.6 API 變更和參數更新。
強制執行輪流驗證規則：移除預先填入的模型輪流內容，並確保最終使用者輪流內容包含非空白文字。
稽核函式呼叫：
- 將多模態資產放在回應酬載中。
- 使用 \n\n 格式化內嵌指令。
- 如果看到與前工具文字相關的 Malformed_Function_Call 錯誤，請參閱「前工具文字規定解決方法」。
- 僅在使用 generateContent API 時：請確保所有 FunctionResponse 物件都包含 call_id 和 name。
Gemini 3 基礎規定：如要瞭解 SDK 更新和保留想法簽章的相關資訊，請參閱「想法簽章」。

定價

在 2026 年 12 月 31 日前，透過 Google AI Studio 和 Gemini Enterprise Agent Platform 試用 Gemini 3.8 Flash 和 Gemini 3.6 Flash，即可享有優惠價格。標準定價將於 2027 年 1 月 1 日生效。如要查看完整定價方案，請參閱定價頁面。

其他模型

後續步驟

在「模型總覽」中查看 API 規格。
請參閱「Interactions API 總覽」，瞭解多代理自動化調度管理功能。
在 Google AI Studio 測試及調整提示。