> ## 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.