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 仕様には、ネストされたすべてのリクエストと応答のスキーマが含まれます。省略した任意フィールドには API のデフォルトが適用されます。公開ネイティブ API は送信された本文を保持し、Gemini が検証します。Playground は送信前に文書化された制約も確認し、安全設定を適用します。

リクエストパラメータ

URL によりモデルは gemini-4-hydrogen に固定されます。リクエスト契約には 11 個のトップレベルフィールドがあります。必須と記されていないフィールドは任意です。省略と JSON null は異なります。公式スキーマで許可されている箇所では、null を許容する任意の JSON が保持されます。

Gemini 4 Hydrogen は明示的なコンテキストキャッシュ（cachedContent と cachedContents リソース）に対応していません。4,096 トークン以上のプロンプトでは暗黙的なキャッシュがデフォルトで有効です。

生成パラメータ

OpenAPI ドキュメントには、各メッセージのネスト型、列挙値、必須プロパティ、文書化された境界値があります。スキーマは公式パラメータを記述するもので、SeedRouter のリクエスト許可リストではありません。呼び出し側が指定したフィールドと値は保持されます。スキーマがフィールドを受け付けることは、すべてのアカウントでの対応を証明しません。minimal は記載された思考レベルに含まれません。Google は temperature、topP、topK、candidateCount は非推奨で削除すべきとしており、カスタムのサンプリング値は無視されます。ネイティブ JSON で送信した場合も、Gemini API が処理するよう変更せずに渡されます。

長文の分割生成

Gemini 4 Hydrogen の 1 回の応答は、ストリーミングで最大 65,536 トークン、非ストリーミングでも最大 65,536 トークンです。さらに出力するには maxOutputTokens を 65,536 より大きくし、自分で回答を継続します。

1. リクエストを送信します。応答が finishReason: "CONTINUATION" で終わる場合、candidates[0].continuationToken を読み取ります。
2. トップレベルの continuationToken にその値を入れ、同じリクエストを再送します。部分出力を contents に追加しないでください。トークンには思考を含むモデルの状態があります。
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"
}

1 回の応答がすべて思考に使われると、空のテキストと CONTINUATION が返る場合があります。これは正常な進行です。毎回、プロンプトとそれまでの全生成内容がモデルに再送されるため、後続の各回で入力トークンが再計上されます。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 スキーマも 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 リソースには、リクエストを処理する認証情報でアクセスできる必要があります。汎用スキーマにはネイティブ MCP 設定がありますが、このモデルでの利用可否は確立されていません。メディアと組み合わせる前に各ツールの公式制限を確認してください。グラウンディングでは、Google は内部ツール指示と関数宣言を入力トークンとして計上します。Playground はカスタム関数を実行しません。

マルチモーダル入力と安全性

contents[].parts[] の項目には、テキスト、インラインメディア、ファイル参照、関数呼び出し/応答、実行パートのうち厳密に 1 つのペイロードを指定します。シグネチャやメディアメタデータを含めることもできます。入力はテキスト、画像、音声、動画、PDF に対応し、出力はテキストのみです。画像や音声の生成、Live API はありません。

インラインバイトには inlineData.mimeType と base64 の data を使います。ファイル参照には fileData.mimeType と fileUri を使います。構文上有効な URL でも、モデルが取得できる証明にはなりません。動画メタデータには開始/終了オフセットと、24 以下の正の fps を指定できます。動画の fileData または inlineData の横に mediaProcessing: "AGENTIC" を指定し、パートごとにエージェント型の動画理解を選びます。デフォルトは静的処理です。videoMetadata には startOffset、endOffset、fps のみを指定します。

安全設定は公式ネイティブ形式を使い、API を通じて変更せずに渡されます。Playground では 4 カテゴリすべてを 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 のトークン料金です。この接続では Flex 割引と Priority 割増は設定されていません。これらの処理枠の対応は引き続き検証が必要です。Google Search グラウンディングではトークン使用量に加えてクエリごとの料金が発生する場合があります。有効化前にツール料金を確認してください。失敗したリクエストには課金されません。現在の料金表をご覧ください。

アカウントのグループ

Default 枠は接尾辞のない gemini-4-hydrogen モデル ID を使います。追加の枠は URL で gemini-4-hydrogen:GROUP_NAME を使います。Playground は利用可能な枠を選びます。API では次のヘッダーでも明示できます。

X-SeedRouter-Group: GROUP_NAME

選択したグループが料金と利用可能な容量を決定します。明示的な選択後に別のグループへ黙って切り替わることはありません。ヘッダーを省略するか auto を指定すると、API キーのデフォルト動作を維持します。

回答を生成せず、API キーで利用可能なグループを確認できます。

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

検証状況

公式ドキュメントは 2026 年 11 月 13 日に確認しました。同日、SeedRouter を通じた各 1 回の有料確認 3 件に合格しました。low 思考の構造化 JSON、xhigh 思考の SSE、low 思考の宣言済み関数の呼び出しです。報告された入力、出力、思考のトークン数は、公開料金で計算すると記録された課金額と一致しました。メディア理解、グラウンディング、Computer Use、継続/ロングデコード、その他の汎用フィールド、処理ティアは未検証です。これらの確認は、比較上の品質やレイテンシを示すものではありません。

参考資料

• Google モデル仕様
• Gemini 4 Hydrogen の新機能
• generateContent による長文の分割生成
• 思考
• 料金
• GenerateContent REST リファレンス