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 Build 中建構全端 Web 應用程式。
使用 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 搜尋接地仍依查詢次數計費。
其他模型¶
- 最新 Gemini 模型
- Gemini 4 Carbon
- Gemini 4 Argon
- Gemini 3.8 Flash
- Gemini 3.6 Flash 與 3.5 Flash-Lite
- 查看所有模型
後續步驟¶
- 閱讀長解碼指南,了解串流、重新連線與權杖計算。
- 在思考指南中了解思考層級與思考摘要的運作方式。
- 在背景執行指南中了解非同步工作。
- 在 Antigravity 代理指南中設定受管理的程式設計工作流程。
- 在 Google AI Studio 中測試並優化提示詞。