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 日生效。如要查看完整的定價級別，請參閱定價頁面。

其他模型

後續步驟