> ## Documentation Index
> Fetch the complete documentation index at: https://mixroute.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini 4 Hydrogen

> Gemini 4 Hydrogen 面向快速编程和多模态智能体工作流，提供共享 1M 上下文和四档思考等级，包含 MixRoute 调用示例。

Gemini 4 Hydrogen 是 Google Gemini 4 系列中注重速度与效率的模型，面向日常编程、交互式智能体和多模态任务。支持文本、图片、视频、音频和 PDF 输入，输出文本。

## 模型规格

| 字段 | 说明 |
| - | - |
| `model` | gemini-4-hydrogen |
| `输入` | 文本、图片、视频、音频、PDF |
| `输出` | 文本 |
| `上下文窗口` | 1,048,576 tokens |
| `思考等级` | low / medium / high / xhigh |

厂商的 1,048,576-token 窗口由输入、思考和输出共享。普通单次请求的思考与输出总上限为 65,536 tokens。更长生成需要单独的续写流程；下方示例不代表 MixRoute 已支持 long decode 或 Interactions。

## 请求示例

将 `MIXROUTE_API_KEY` 设置为你的 MixRoute API Key。

### Gemini 原生 API

```bash theme={null}
curl --request POST "https://api.mixroute.ai/v1beta/models/gemini-4-hydrogen:generateContent" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Reply with exactly OK."
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 256,
    "thinkingConfig": {
      "thinkingLevel": "low"
    }
  }
}'
```

### OpenAI 兼容 Chat Completions

```bash theme={null}
curl --request POST "https://api.mixroute.ai/v1/chat/completions" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gemini-4-hydrogen",
  "messages": [
    {
      "role": "user",
      "content": "Reply with exactly OK."
    }
  ],
  "max_tokens": 256,
  "reasoning_effort": "low"
}'
```

## 请求参数

| 字段 | 说明 |
| - | - |
| `contents` | 使用 role 和 parts 表示会话内容，文本放在 parts\[].text。 |
| `generationConfig.maxOutputTokens` | 推理和输出文本的总预算，不是期望的回答长度。 |
| `generationConfig.thinkingConfig.thinkingLevel` | 支持 low、medium、high（厂商默认）和 xhigh。不能用 minimal 关闭思考。优先使用 `thinkingLevel`，不使用已弃用的 `thinkingBudget`；输出预算需同时容纳推理和最终答案。 |
| `model / messages / max_tokens / reasoning_effort` | 通过 messages 调用 gemini-4-hydrogen。示例使用 low 推理强度和较小输出预算。 |

## 接入说明

* 示例使用文本输入。多模态格式、函数调用和结构化输出分别遵循对应的 Gemini 协议，同时受 MixRoute 路由限制。
* 省略 `temperature`、`topP`、`topK` 和 `candidateCount`：Google 对该模型忽略自定义采样值。不支持通过 `cachedContent` 指定显式上下文缓存。
* 厂商模型规格中列出的 Google 内置工具，不代表所有托管工具、Files API 操作或续写流程都能通过 MixRoute 使用。

可用性和价格取决于 MixRoute 路由，请查看[模型广场](https://console.mixroute.ai/models)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.