Gemini 4 Hydrogen

Gemini 4 Hydrogen 为日常编码和智能体企业工作流带来了前沿智能，兼具速度和效率。

Hydrogen 与早期 Gemini 模型的不同之处体现在以下几个方面：

  • 统一的输入和输出词元限制以及长解码：Hydrogen 具有统一的 1,048,576 词元限制，涵盖所有受支持 API 接口（GenerateContent API、Interactions API 和与 OpenAI 兼容的 Chat Completions API）的输入和输出词元（其中输出包括思考、函数调用和最终回答）。单个前台片段最多可生成 65,536 个输出词元（流式或非流式）。在 Interactions API 和 GenerateContent API (v1beta1) 中，您都可以使用长解码将输出扩展到最多 1,048,576 个 token（减去输入 token）：Google Gen AI SDK 和 Agent Studio 会自动跨片段处理 continuation_token，您也可以在 Interactions API 中使用 background=true，或在自定义延续循环中传递 continuation_token（已知问题：continuation_token 仅在 v1beta1 API 中受支持，Google Gen AI SDK 默认使用该 API）。如需了解详情，请参阅 Gemini 4 Hydrogen 开发者指南。
  • 思考等级：Hydrogen 支持思考等级 LOW、MEDIUM、HIGH（默认）和 XHIGH。设置 thinking_budget 或 thinking_level="MINIMAL" 会返回 HTTP 400 验证错误。
  • 采样参数：采样参数（temperature、top_p 和 top_k）的自定义值会被忽略。
  • 上下文缓存：Hydrogen 仅支持隐式缓存（至少 4,096 个 token），默认启用持久缓存。不支持显式上下文缓存。自 2027 年 1 月 12 日起，Gemini 4 Hydrogen 及更高版本的模型支持具有 TTL 配置的缓存控制功能。您可以通过 TTL 配置选择要缓存的内容以及缓存内容的有效时长。默认情况下，缓存写入按标准输入 token 价格的 1.25 倍计费，保留时间越长，费用越高。如需了解详情，请参阅价格。
  • Office 和 OpenDocument 文件输入：除了 PDF (application/pdf) 和纯文本 (text/plain) 之外，Hydrogen 还接受 Microsoft Office（.docx、.dotx、.doc、.pptx、.ppt、.xlsx、.xls）和 OpenDocument（.odt、.odp、.ods）文件，这些文件可以以内嵌方式或从 Cloud Storage 传入 GenerateContent API 和 Interactions API，包括在多模态 FunctionResponse 部分中。

在 Agent Studio 中试用 部署示例应用 开发者指南 价格

注意：“部署示例应用”需要一个启用了结算功能和 Agent Platform API 的 Cloud de Confiance by S3NS 项目。
模型 ID gemini-4-hydrogen
模态
文本 输入和输出
图片 仅输入
音频 仅输入
视频 仅输入
token 数量上限 上下文窗口 1,048,576
输出词元数上限 1,048,576
功能
工具
API
使用选项
输入大小限制
  • GenerateContent API：500 MiB（压缩后）
  • Interactions API： 256 MiB（压缩后，同步或流式传输）；9.75 MiB（未压缩，延迟，当 background 和 store 为 true 时）
Interactions API URI 限制 在 Interactions API 上，每次请求中所有模态的 Cloud Storage (gs://) URI 总数不得超过 100 个，包括使用 previous_interaction_id 从先前轮次中继承的 URI。generateContent 支持的 gs:// URI 数量上限取决于每种模态的模型项限制（如果包含纯文本文件，则最多可包含 6,500 个多模态文件）。
技术规格 图片
  • 每个提示的图片数量上限：3,000（图片和文档总和）
  • 内嵌部分的大小上限 (GenerateContent API)：256 MB
  • Cloud Storage 中每个文件的文件大小上限：2 GiB 减去 500 KiB
  • 来自公开 HTTP 或 HTTPS 网址的每个文件的文件大小上限：15 MiB
  • 在控制台中直接本地上传的每个文件的文件大小上限： 7 MiB 内嵌（最多 50 MiB 暂存到 Cloud Storage）
  • 在控制台中通过 Google 云端硬盘导入的每个文件的文件大小上限：7 MB（总共 10 MB）
  • 默认分辨率 token 数：1,120
  • 支持的 MIME 类型：
    image/png、image/jpeg、image/webp、image/heic、image/heif
文字
  • 每个提示的文件数量上限： 3,000 个文档（与图片共享；如果包含纯文本，则总文件数上限为 6,500 个）
  • 每个文件的页数上限：3,000
  • 内嵌部分的大小上限 (GenerateContent API)：256 MB
  • Cloud Storage 中每个文件的文件大小上限：2 GiB 减去 500 KiB
  • 来自公开 HTTP 或 HTTPS 网址的每个文件的文件大小上限：15 MiB
  • 在控制台中直接本地上传的每个文件的文件大小上限： 7 MiB 内嵌（最多 50 MiB 暂存到 Cloud Storage）
  • 在控制台中通过 Google 云端硬盘导入的每个文件的文件大小上限：7 MB（总共 10 MB）
  • 默认分辨率 token 数：560
  • 适用于扫描版 PDF 的 OCR：默认不使用
  • 支持的 MIME 类型：
    application/pdf、text/plain、application/msword、application/vnd.openxmlformats-officedocument.wordprocessingml.document、application/vnd.openxmlformats-officedocument.wordprocessingml.template、application/vnd.oasis.opendocument.text、application/vnd.ms-powerpoint、application/vnd.openxmlformats-officedocument.presentationml.presentation、application/vnd.oasis.opendocument.presentation、application/vnd.ms-excel、application/vnd.openxmlformats-officedocument.spreadsheetml.sheet、application/vnd.oasis.opendocument.spreadsheet
视频
  • 视频时长上限（包含音频）：约 45 分钟
  • 视频时长上限（不含音频）：约 1 小时
  • 每个提示的视频数量上限：10
  • 内嵌部分的大小上限 (GenerateContent API)：256 MB
  • Cloud Storage 中每个文件的文件大小上限：2 GiB 减去 500 KiB
  • 来自公开 HTTP 或 HTTPS 网址的每个文件的文件大小上限：15 MiB
  • 每帧的默认分辨率 token 数：70
  • 支持的 MIME 类型：
    video/x-flv、video/quicktime、video/mpeg、video/mpegs、video/mpg、video/mp4、video/webm、video/wmv、video/3gpp
音频
  • 每个提示的音频长度上限：约 8.4 小时或最多 100 万个 token
  • 每个提示的音频文件数量上限：1,000
  • 内嵌部分的大小上限 (GenerateContent API)：256 MB
  • Cloud Storage 中每个文件的文件大小上限：2 GiB 减去 500 KiB
  • 来自公开 HTTP 或 HTTPS 网址的每个文件的文件大小上限：15 MiB
  • 语音理解用途：音频总结、转写和翻译
  • 支持的 MIME 类型：
    audio/x-aac、audio/flac、audio/mp3、audio/m4a、audio/mpeg、audio/mpga、audio/mp4、audio/ogg、audio/pcm、audio/wav、audio/webm
参数默认值
  • 温度：1.0（固定；自定义值会被忽略）
  • topP：0.95（固定；自定义值会被忽略）
  • topK：64（固定值；自定义值会被忽略）
  • candidateCount：1（固定值）
支持的区域

模型可用性

  • 全球：global
  • 多区域：us、eu

机器学习处理

  • 多区域：us、eu

预配吞吐量

  • 全球：global
  • 多区域：us、eu

标准 PayGo

  • 全球：global
  • 多区域：us、eu

Priority PayGo

  • 全球：global
  • 多区域：us、eu
知识截点日期 2026 年 3 月
版本
  • gemini-4-hydrogen
    • 发布阶段：正式版
    • 发布日期：2026 年 11 月 12 日
安全控制 在线预测
  • 数据驻留
  • CMEK
  • VPC-SC
  • AXT
批量推理
  • 数据驻留
  • CMEK
  • VPC-SC
  • AXT
上下文缓存
  • 数据驻留
  • CMEK
  • VPC-SC
  • AXT
如需了解详情，请参阅安全控制。