跳轉到

Gemini 4 Hydrogen 的新功能

Gemini 4 Hydrogen(gemini-4-hydrogen)將尖端智慧帶給所有人,同時兼顧速度與效率,適用於日常程式設計與代理工作流程。

Gemini 4 Hydrogen 在 Google AI Studio 與 Gemini API 的免費層級與付費層級皆可使用(同時支援 GenerateContent 與 Interactions API)。與 Gemini 4 Carbon 和 Gemini 4 Argon 相同,它具備統一的 100 萬權杖上下文視窗,並支援最長 100 萬權杖的長解碼。此外,它還新增了第四個思考層級 xhigh,與 low、medium 以及預設的 high 並列。

模型卡

查看權杖上限、支援的功能與完整規格。

在 AI Studio 中建構

在 AI Studio Build 中建構全端 Web 應用程式。

從 3.8 Flash 遷移

使用 Gemini 3.8 Flash 遷移檢查清單升級現有工作負載。

本指南說明 Gemini 4 Hydrogen 的新功能、API 變更、程式碼範例與遷移指引。

新模型

模型 模型 ID 思考層級 付費層級價格
Gemini 4 Hydrogen gemini-4-hydrogen low、medium、high(預設)、xhigh 每 1M 輸入 $1.50、每 1M 輸出 $7.50

完整規格請參閱 Gemini 4 Hydrogen 模型頁面 與最新 Gemini 模型。

快速入門

使用 Interactions API 向 gemini-4-hydrogen 傳送要求。模型預設使用 high 思考層級,同步輸出權杖上限為 64K。

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-4-hydrogen",
    input="Build an interactive single-file HTML token bucket rate-limiter simulator with live sliders for burst size and request traffic."
)

print(interaction.output_text)
import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
  model: "gemini-4-hydrogen",
  input: "Build an interactive single-file HTML token bucket rate-limiter simulator with live sliders for burst size and request traffic.",
});

console.log(interaction.output_text);
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-4-hydrogen",
    "input": "Build an interactive single-file HTML token bucket rate-limiter simulator with live sliders for burst size and request traffic."
  }'

Gemini 4 Hydrogen 的新功能

  • 快速的代理執行:能撰寫更簡潔的程式碼;與 Gemini 3.8 Flash 相比,透過標示缺少的脈絡而非自行猜測,將捏造說法的情形減少 5 倍以上;能平行批次處理讀取與搜尋工具呼叫,並在工具呼叫失敗時做出更好的調整。
  • 四種可設定的思考層級:支援 low、medium、high(預設)與全新的 xhigh 層級,讓您能更精細地控管延遲與成本,並在任務需要時進行更深入的推理。詳情請參閱思考層級一節。
  • 專為多模型協調而設計:可獨立用於程式設計與代理工作,也可搭配 Carbon 與 Argon,以較低的延遲驅動平行的 worker 與 verifier 代理,且不會推高權杖成本。
  • 更強的多模態推理:能以更高的準確度讀取並綜合表格、圖表、密集的 PDF、圖片、音訊與影片,並使用代理式影片理解檢視特定影格與視覺細節。
  • 統一的 100 萬上下文視窗與長解碼:輸入、思考與輸出權杖共用同一個 1,048,576 權杖的視窗。透過背景執行或用戶端接續,回覆長度可超過 64K,最長可達 100 萬權杖。請參閱長解碼。
  • Managed Agents 的預設模型:Antigravity 代理 現在預設使用 Gemini 4 Hydrogen(gemini-4-hydrogen)。

在 Hydrogen、Carbon、Argon 與其他模型之間做選擇

Gemini 4 Hydrogen、Gemini 4 Argon 與 Gemini 4 Carbon 共用相同的 100 萬統一上下文視窗、長解碼架構與內建工具。請依您的推理深度、延遲與成本目標,挑選最合適的模型:

  • Gemini 4 Hydrogen(gemini-4-hydrogen):在處理複雜的代理工作流程時兼顧速度與效率,價格為每 100 萬輸入權杖 $1.50、每 100 萬輸出權杖 $7.50。適用於日常程式設計、互動式 Web 應用程式、使用工具的代理、多模態文件工作流程,以及平行子代理執行。建議從 Gemini 3.8 Flash 以及更早的 Gemini 3 與 2.5 模型升級至此模型。
  • Gemini 4 Carbon(gemini-4-carbon):我們最強大的前沿模型。Carbon 會在每一輪投入更多思考權杖,用於測試假設並驗證困難架構、除錯、科學與安全稽核中的邊界情況。
  • Gemini 4 Argon(gemini-4-argon):當您希望以比 Carbon 更低的權杖用量處理大多數進階的長程任務時,請使用 Argon。
  • Gemini 3.5 Flash-Lite(gemini-3.5-flash-lite):我們速度最快、成本最低的模型。請將 Flash-Lite 用於大量分類、路由,以及次秒級延遲目標。

您也可以在同一個工作流程中搭配使用 Carbon 與 Hydrogen:讓 Carbon 規劃系統介面或解決棘手的阻礙,再將程式碼編輯、平行子代理任務與測試執行委派給 Hydrogen。完整比較請參閱最新 Gemini 模型。

了解思考層級

思考層級 是您在 Gemini 4 Hydrogen 中控管品質、延遲與權杖用量的主要手段。模型預設為 high,並新增了 xhigh。

思考層級 權杖用量 適用時機
low 權杖用量最少、延遲最低 對成本與延遲敏感的工作負載,例如快速聊天與高輸送量處理。在代理任務上仍具備足夠能力。
medium 權杖用量較低、回覆速度較快 互動式程式設計、即時 UI 原型製作、即時回應的聊天,以及對延遲敏感的工具呼叫。
high(預設) 在智慧與速度之間取得平衡 建議作為大多數任務的預設值,包括複雜程式設計、代理執行、工具呼叫與多模態知識工作。
xhigh 權杖用量最多、推理最深入 僅保留給 high 不足以應付的困難多步驟程式設計與代理問題,且您能接受以較高的延遲與權杖用量作為代價時使用。

大多數複雜任務請先從 high 開始,並將 xhigh 保留給 high 不足以應付的困難多步驟問題。使用 xhigh 會增加延遲與權杖用量,且可能在較簡單的提示詞上造成過度思考。請在四個層級下都執行評測,並將 max_output_tokens 設得夠高,避免上限截斷答案。接著,挑選能達到您品質門檻的最低 thinking_level。詳情請參閱思考指南。

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-4-hydrogen",
    input="Audit this payment retry queue for race conditions and rewrite the lock acquisition logic.",
    generation_config={
        "thinking_level": "xhigh"
    }
)

print(interaction.output_text)
import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
  model: "gemini-4-hydrogen",
  input: "Audit this payment retry queue for race conditions and rewrite the lock acquisition logic.",
  generation_config: {
    thinking_level: "xhigh",
  },
});

console.log(interaction.output_text);
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-4-hydrogen",
    "input": "Audit this payment retry queue for race conditions and rewrite the lock acquisition logic.",
    "generation_config": {
      "thinking_level": "xhigh"
    }
  }'

更大的輸出與長解碼

Gemini 4 Hydrogen 支援最長 65,536 個權杖的同步輸出,以及最長可達 100 萬統一上下文視窗的長解碼:

  • 使用 thinking_level 控管推理深度:thinking_level 欄位決定模型在回答前進行多少推理。max_output_tokens 欄位則限制思考與輸出權杖的總量,因此請為最終答案預留足夠的空間。
  • 透過背景執行或接續產生超過 64K 權杖的內容:同步回覆在串流與非串流要求下,每一跳最多支援 65,536 個權杖。若要產生更長的輸出,請將 max_output_tokens 設為高於 65,536(上限為 1,048,576 減去您的輸入權杖數),並將 background 設為 true,讓我們的伺服器以每跳 64K 權杖的方式接續產生;或者在最新版 Google GenAI SDK 中使用用戶端接續。
import time
from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-4-hydrogen",
    input="Generate a complete multi-module migration specification and test suite for this service.",
    background=True,
    generation_config={
        "max_output_tokens": 262144,
        "thinking_level": "high",
    },
)

while interaction.status in ("in_progress", "queued"):
    time.sleep(5)
    interaction = client.interactions.get(id=interaction.id)

# Join text across all 64K continuation hops.
text = "".join(
    content.text
    for step in interaction.steps
    if step.type == "model_output"
    for content in step.content
    if content.type == "text"
)
print(text)
print("Status:", interaction.status)
print("Usage:", interaction.usage)
import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({});

let interaction = await client.interactions.create({
  model: "gemini-4-hydrogen",
  input: "Generate a complete multi-module migration specification and test suite for this service.",
  background: true,
  generation_config: {
    max_output_tokens: 262144,
    thinking_level: "high",
  },
});

while (interaction.status === "in_progress" || interaction.status === "queued") {
  await new Promise((resolve) => setTimeout(resolve, 5000));
  interaction = await client.interactions.get(interaction.id);
}

// Join text across all 64K continuation hops.
const text = interaction.steps
  .filter((step) => step.type === "model_output")
  .flatMap((step) => step.content ?? [])
  .filter((content) => content.type === "text")
  .map((content) => content.text)
  .join("");
console.log(text);
console.log("Status:", interaction.status);
console.log("Usage:", interaction.usage);
ID=$(curl -s -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-4-hydrogen",
    "input": "Generate a complete multi-module migration specification and test suite for this service.",
    "background": true,
    "generation_config": {
      "max_output_tokens": 262144,
      "thinking_level": "high"
    }
  }' | jq -r '.id')

while true; do
  RESP=$(curl -s "https://generativelanguage.googleapis.com/v1beta/interactions/$ID" \
    -H "x-goog-api-key: $GEMINI_API_KEY")
  STATUS=$(echo "$RESP" | jq -r '.status')
  if [[ "$STATUS" != "in_progress" && "$STATUS" != "queued" ]]; then
    echo "$RESP" | jq -r '[.steps[]? | select(.type == "model_output") | .content[]? | select(.type == "text") | .text] | join("")'
    break
  fi
  sleep 5
done

如果您將 background 設為 true 卻未設定 max_output_tokens,伺服器會在 65,536 個權杖後停止。

建議使用背景執行來執行長解碼。若需要自訂重試控制,或使用不儲存的互動,請在 Interactions API 或 GenerateContent API 中使用用戶端接續。串流與權杖計算的詳情請參閱長解碼指南。

設定輸出權杖上限

max_output_tokens 欄位限制單一回覆中思考與輸出權杖的總量。請使用下列起始值,在控制支出的同時避免答案被截斷:

  • 一般任務:保留 65,536 的預設值,或省略 max_output_tokens。
  • 上限過低的現有應用程式:移除寫死的低上限(例如 8,192),或將 max_output_tokens 提高到 65,536。若要減少權杖用量,請改為降低思考層級。
  • 長輸出與多步驟任務:將 background 設為 true,並將 max_output_tokens 設為 131,072 或 262,144,上限為 1,048,576 減去您的輸入權杖數。

更新後的 Antigravity 代理

由於效能與推理能力有所提升,Gemini Managed Agents 中的 Antigravity 代理 現在預設以 Gemini 4 Hydrogen(gemini-4-hydrogen)建構。

from google import genai

client = genai.Client(http_options={"api_version": "v1beta"})

interaction = client.interactions.create(
    agent="antigravity-preview-09-2026",
    input=(
        "Audit https://web.dev for performance, Core Web Vitals, and SEO. "
        "Query Google's PageSpeed Insights API for both Mobile and Desktop strategies. "
        "Check search indexing with Google Search for site:web.dev. "
        "Format the output as a side-by-side scorecard table with prioritized fixes."
    ),
    environment="remote",
)

print(interaction.output_text)
import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({ httpOptions: { apiVersion: "v1beta" } });

const interaction = await client.interactions.create({
  agent: "antigravity-preview-09-2026",
  input:
    "Audit https://web.dev for performance, Core Web Vitals, and SEO. " +
    "Query Google's PageSpeed Insights API for both Mobile and Desktop strategies. " +
    "Check search indexing with Google Search for site:web.dev. " +
    "Format the output as a side-by-side scorecard table with prioritized fixes.",
  environment: "remote",
}, { timeout: 300000 });

console.log(interaction.output_text);
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -d '{
    "agent": "antigravity-preview-09-2026",
    "input": "Audit https://web.dev for performance, Core Web Vitals, and SEO. Query Google'\''s PageSpeed Insights API for both Mobile and Desktop strategies. Check search indexing with Google Search for site:web.dev. Format the output as a side-by-side scorecard table with prioritized fixes.",
    "environment": "remote"
  }'

底層的 Gemini 模型可使用 agent_config 進行設定。

遷移檢查清單

如果您使用支援技能的程式設計代理(例如 Antigravity),請安裝 gemini-api-dev 技能 以自動完成這次升級:

/gemini-api-dev migrate my app to Gemini 4 Hydrogen

從 Gemini 3.8 Flash 與更早版本遷移

Gemini 4 Hydrogen 採用與 Carbon 和 Argon 相同的 Gemini 4 API 設計。從 gemini-3.8-flash 或更早的 Gemini 3 模型升級時,請檢閱下列變更:

  • 更新模型 ID:將模型字串從 gemini-3.8-flash 改為 gemini-4-hydrogen。
  • 留意統一的 100 萬上下文視窗:Gemini 3.8 Flash 將 100 萬輸入與 64K 輸出的預算分開計算;Hydrogen 則讓輸入、思考與輸出權杖共用同一個 1,048,576 權杖的視窗,同時在串流與非串流呼叫中都保留單次要求 65,536 的預設值與上限。請移除寫死的低 max_output_tokens 上限,或將其提高到 65,536。
  • 設定 thinking_level:Hydrogen 的預設值為 high 而非 medium,新增了 xhigh,並會以錯誤拒絕 minimal。請在您的評測套件上測試 medium 與 high,以在速度與成本之間取得平衡。
  • 停用明確上下文快取:Gemini 4 Hydrogen 不支援明確快取(cachedContents 與 caches.create)。請從要求中移除 cached_content 欄位。隱含快取 會預設在至少 4,096 個權杖的提示詞上執行,並在快取命中時為快取的輸入權杖提供 95% 的折扣。
  • 移除取樣參數:請從要求中移除 temperature、top_p 與 top_k。若傳送範圍內的自訂值,伺服器會加以忽略;超出範圍的值則會傳回 400 驗證錯誤。
  • 宣告原生工具或結構化輸出結構描述:請勿透過系統指令提示模型在未宣告任何工具的情況下,發出自訂的原始文字 JSON 工具呼叫,這可能會傳回 MALFORMED_FUNCTION_CALL。請一律使用函式呼叫 以原生方式宣告工具,或使用結構化輸出 限制 JSON 回覆。
  • 保留對話狀態與思考簽章:在多輪與工具呼叫工作階段中,請在 Interactions API 中使用 previous_interaction_id。在由用戶端管理的 generateContent 歷史記錄中,請在每一輪都原封不動地傳回先前的模型輪次與思考簽章。請勿將同一個思考簽章複製到平行的 functionCall 部分。
  • 對超過 64K 的輸出使用背景執行:對於長度超過 64K 權杖的回覆,請將 background 設為 true,並將 max_output_tokens 設為高於 65,536(或在最新版 SDK 中使用用戶端接續)。
  • 檢閱權杖計費估算:我們會計算並收費模型處理的每一個權杖,包括思考權杖,以及內部的接地系統指令與函式宣告。

從 Gemini 4 Carbon 與 Argon 遷移或與其搭配

如果您目前執行的是 gemini-4-carbon 或 gemini-4-argon,新增或切換到 gemini-4-hydrogen 時,不需要變更要求結構描述:

  • 更新模型 ID:在獨立要求或子代理輪次中,將 model 設為 gemini-4-hydrogen。
  • 檢查預設思考層級:Hydrogen 預設為 high 並支援 xhigh,而 Carbon 與 Argon 預設為 medium,上限為 high。設定 thinking_level,即可取得 medium 或 xhigh 的行為。
  • 64K 非串流跳躍:Hydrogen 在 REST 與 SDK 呼叫中,每一跳非串流最多支援 65,536 個權杖;相較之下,Carbon 與 Argon 在每一跳非串流 REST 中最多支援 32,768 個權杖。
  • 跨輪次切換模型:在同一個多輪工作階段中,將規劃輪次導向 gemini-4-carbon、執行輪次導向 gemini-4-hydrogen,並使用 previous_interaction_id 連接各輪次(或透過保留無狀態模式下的思考步驟 來達成;請參閱多輪模型相容性)。

定價

Gemini 4 Hydrogen 可在 Gemini API 與 Google AI Studio 的免費層級使用;付費層級則在完整的 100 萬上下文視窗範圍內採用單一標準定價:

  • 免費層級:免費使用(受速率限制約束;請參閱速率限制)
  • 輸入權杖:每 100 萬權杖 $1.50
  • 快取的輸入權杖:隱含快取為快取的輸入提供 95% 的折扣,降至每 100 萬權杖 $0.075。

  • 輸出權杖(包括思考權杖):每 100 萬權杖 $7.50

我們會計算並收費模型處理的每一個權杖,包括使用接地時所涉及的思考權杖,以及內部工具的系統指令與函式宣告。使用 Google 搜尋接地仍依查詢次數計費。

完整的層級詳情與速率限制請參閱定價頁面 與速率限制頁面。

其他模型

後續步驟