Gemini 4 Hydrogen

以原生 Gemini 格式使用 gemini-4-hydrogen。模型頁面提供 Playground 和目前價格。Gemini 4 Hydrogen 與 Gemini 4 Argon 使用相同請求格式；Google 指南說明，兩者之間切換只需更改模型 ID。

模型 ID

執行範例前，請檢查模型清單及可用層級。Default 層級不可用時，請使用發現介面回傳的完整呼叫 ID。

快速範例

curl https://api.seedrouter.ai/v1beta/models/gemini-4-hydrogen:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Find the race condition in a retry loop that re-reads a balance before locking it."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"high"},"maxOutputTokens":65536}}'

模型應放在 URL 中。contents 為必填項。回答包含原生 candidates、finishReason 和 usageMetadata；請在對話歷史中保留完整內容部分，包括 thoughtSignature。困難提示詞的處理可能持續數分鐘。Google 建議將用戶端逾時設為 20 分鐘。使用串流模式可在輸出可用時陸續接收。

端點

OpenAPI 規格包含所有巢狀請求和回應 schema。省略選填欄位時使用 API 預設值。公開原生 API 保留提交的請求主體，交由 Gemini 驗證。Playground 還會在提交前檢查文件約束，並執行其安全設定。

請求參數

URL 將模型固定為 gemini-4-hydrogen。請求契約包含 11 個頂層欄位。除非標為必填，否則欄位均選填；省略不同於 JSON null。官方 schema 允許時，會保留可為 null 的任意 JSON。

Gemini 4 Hydrogen 不支援明確建立的上下文快取（cachedContent 和 cachedContents 資源）。至少 4,096 token 的提示詞預設啟用隱含快取。

生成參數

OpenAPI 文件列出了每則訊息的巢狀類型、列舉、必填屬性和文件規定的邊界。Schema 描述官方參數，並非 SeedRouter 請求白名單。呼叫方提供的欄位和值會被保留。欄位被 schema 接受，不代表每個帳戶都支援。minimal 不在列出的思考層級中。Google 表示 temperature、topP、topK 和 candidateCount 已棄用，應移除；自訂取樣值會被忽略。如果透過原生 JSON 提交，它們仍會原樣傳遞，交由 Gemini API 處理。

長文分段生成

Gemini 4 Hydrogen 每次串流回應最多回傳 65,536 token，非串流回應同樣最多回傳 65,536 token。需要更長輸出時，將 maxOutputTokens 設為大於 65,536，並自行接續回答：

1. 傳送請求。如果回應以 finishReason: "CONTINUATION" 結束，讀取 candidates[0].continuationToken。
2. 將該值放入頂層 continuationToken 欄位，重發同一個請求。不要將部分輸出追加到 contents；token 攜帶模型狀態，包括其思考。
3. 重複操作，直至 finishReason 為 STOP 或 MAX_TOKENS。

{
  "contents": [{"role": "user", "parts": [{"text": "Write a complete, rigorous proof of the prime number theorem."}]}],
  "generationConfig": {"thinkingConfig": {"thinkingLevel": "high"}, "maxOutputTokens": 262144},
  "continuationToken": "TOKEN_FROM_THE_PREVIOUS_RESPONSE"
}

一次回應若全部用於思考，可能回傳空文字並帶有 CONTINUATION；這是正常進展。每輪請求都會將提示詞和截至目前已生成的全部內容送回模型，因此後續每輪請求都會重新計算輸入 token。SeedRouter 將每輪請求分別作為獨立請求計費。Interactions API 的伺服器端 background 模式不屬於此端點。

結構化輸出

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 65536,
    "responseMimeType": "application/json",
    "responseJsonSchema": {
      "type": "object",
      "properties": {"ok": {"type": "boolean"}},
      "required": ["ok"]
    }
  }
}

舊版 responseSchema 和 responseJsonSchema 欄位不能同時使用。兩者都要求 responseMimeType: "application/json"。新版 responseFormat.text schema 同樣必須指定 JSON。在該訊息中使用 REST 列舉拼寫（APPLICATION_JSON 和 TEXT_PLAIN）。請求原樣傳遞；媒體 MIME 類型和任意函式 JSON 不會被改寫。

函式與內建工具

使用 tools[].functionDeclarations，提供名稱以及 parameters 或 parametersJsonSchema 其中之一，不能同時提供。函式選擇位於 toolConfig.functionCallingConfig；allowedFunctionNames 要求 ANY 或 VALIDATED，且名稱必須已宣告。

由你的應用程式執行回傳的函式，並在下一輪對話中提供結果。保留每個原始 thoughtSignature、函式呼叫和函式回應。序列化不透明函式參數時，不要對數字識別碼進行四捨五入。

Google 為此模型列出了 Search、Maps、程式碼執行、URL 上下文、File Search 和 Computer Use。File Search 資源需要處理該請求的憑證具備存取權限。通用 schema 中包含原生 MCP 設定，但尚未確定此模型是否可用。將工具與媒體結合前，請檢查各工具的官方限制。使用 grounding 時，Google 將內部工具指令和函式宣告計為輸入 token。Playground 不會執行你的自訂函式。

多模態輸入與安全

每個 contents[].parts[] 項恰好包含一種負載：文字、內嵌媒體、檔案引用、函式呼叫/回應，或執行部分。還可攜帶簽章或媒體中繼資料。輸入支援文字、圖片、音訊、影片和 PDF；輸出僅為文字。模型不生成圖片或音訊，也沒有 Live API。

對於內嵌位元組，使用 inlineData.mimeType 和 base64 data。對於檔案引用，使用 fileData.mimeType 和 fileUri。URL 語法有效不代表模型能取得其內容。影片中繼資料可指定起止偏移量及不大於 24 的正數 fps。在影片的 fileData 或 inlineData 旁設定 mediaProcessing: "AGENTIC"，可按內容部分選擇代理式影片理解；預設採用靜態處理。videoMetadata 僅容納 startOffset、endOffset 和 fps。

安全設定使用官方原生格式，經 API 原樣傳遞。在 Playground 中，全部四個類別都必須設為 BLOCK_MEDIUM_AND_ABOVE 或更嚴格；更低門檻只能透過 API 使用。

JSON 回應與串流模式

generateContent 回傳原生 JSON。streamGenerateContent?alt=sse 在 SSE data: 事件中輸出原生 JSON。重要欄位包括 candidates[].content.parts、finishReason、continuationToken、safetyRatings、groundingMetadata、promptFeedback、modelVersion、responseId 和 usageMetadata。

在對話歷史中保留完整原生內容。思考摘要不同於思考簽章。連線中斷不能證明生成已失敗或完成；傳送另一個請求前，請檢查部分結果和帳戶記錄。串流用量為累計值，請使用最新計數器，不要將各個片段相加。

用量與價格

promptTokenCount 包含快取輸入。cachedContentTokenCount 按快取輸入費率收費，不會再按非快取輸入重複計費。計費輸出包含 candidatesTokenCount 加 thoughtsTokenCount。Hydrogen 預設採用 high 思考層級。與其他模型比較用量時，請明確設定層級。

本模型沒有按上下文長度劃分的價格階梯。SeedRouter 目前價格使用 Standard token 費率；此串接尚未設定 Flex 折扣和 Priority 附加費。這些處理層級是否受支援，仍需驗證。Google Search grounding 可能在 token 用量之外產生按查詢計費的費用；啟用前請檢查工具價格。失敗的請求不收費。參見即時價格表。

帳戶分組

Default 層級使用不帶後綴的 gemini-4-hydrogen 模型 ID。其他層級在 URL 中使用 gemini-4-hydrogen:GROUP_NAME。Playground 會選擇可用層級；API 也接受明確指定的請求標頭：

X-SeedRouter-Group: GROUP_NAME

所選分組決定價格和可用容量；明確選擇後，不會靜默切換到其他分組。省略請求標頭或使用 auto，可保留 API key 的預設行為。

無需生成回答，即可檢查 API key 可用的分組：

curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-hydrogen" \
  -H "Authorization: Bearer YOUR_SEEDROUTER_KEY"

驗證狀態

官方文件已於 2026 年 11 月 13 日核對。當天，透過 SeedRouter 進行的三項單次嘗試付費檢查均通過：使用 low 思考等級的結構化 JSON、使用 xhigh 思考等級的 SSE，以及使用 low 思考等級的已宣告函式呼叫。回報的輸入、輸出及思考 token 數依公布費率計算後，與紀錄費用一致。媒體理解、溯源、Computer Use、接續/長解碼、其他通用欄位及處理層級仍未驗證。這些檢查無法確立相對品質或延遲結論。

參考資料

• Google 模型規格
• Gemini 4 Hydrogen 更新說明
• 透過 generateContent 進行長文分段生成
• 思考
• 價格
• GenerateContent REST 參考