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 参考