はじめに
OpenAI のチャット形式でメッセージを送ると、テキスト、ツール呼び出し、スキーマに沿った JSON が返ります。思考レベル、応答の長さ、停止シーケンスは任意です。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | テキスト |
| 共有コンテキスト | 1,048,576 トークン |
| max_tokens の上限 | 65,536 |
主な機能とハイライト
毎日の開発サイクルに合わせた設計
Google は Hydrogen を、リポジトリの修正やデバッグ、1 日に何度も繰り返すエージェント処理向けに位置づけています。深い探索よりも素早い応答が重要な場面に適しています。
4 段階で調整できる思考
名前の変更には low、通常の修正には medium か high、2 回直しても通らないテストには xhigh というように使い分けられます。
コードで検証できる応答
response_format に JSON スキーマを渡すか、tools に関数を宣言します。Hydrogen が次の手順を提案し、実行するかどうかはアプリケーションが判断します。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
messages | はい | Hydrogen との会話を古い順に並べます。ユーザーメッセージにはテキストと |
max_tokens | いいえ | Hydrogen の応答枠で、1 から 65,536 まで指定できます(既定は 4,096)。思考もこの枠を使うため、小さすぎると本文が出る前に終了します。 |
reasoning_effort | いいえ | Hydrogen が応答前に考える深さです。low、medium、high、xhigh から選びます。 |
stop | いいえ | 1 つ、または最大 4 つの文字列を指定します。Hydrogen は最初に一致した箇所の直前で応答を終え、一致した文字列は返しません。 1 文字以上 · 1 件以上 · 4 件以内 |
temperature | いいえ | Hydrogen はクライアントとの互換性のために 0 から 2 までの値を受け付けます。Google のドキュメントによると範囲内の値は無視されるため、応答は変わりません。 |
top_p | いいえ | Hydrogen はクライアントとの互換性のために 0.01 から 1 までの値を受け付けます。Google のドキュメントによると、この値も無視されます。 |
tools | いいえ | Hydrogen が呼び出しを要求できる関数で、最大 128 件定義できます。引数の確認と処理の実行はアプリケーションが行います。 128 件以内 |
parallel_tool_calls | いいえ | false を指定しない限り、Hydrogen は 1 ターンで複数の関数を要求できます。何を実行するかは引き続きアプリケーションが判断します。 デフォルト値: |
tool_choice | いいえ | このターンで Hydrogen が関数を呼び出せるかを指定します。auto、none、required、または特定の関数を選べます。 |
response_format | いいえ | Hydrogen に JSON を要求します。独自の |
料金
入力 $1.3247 / 出力 $6.6233 100 万トークンあたり
ユースケース
失敗するテストを直す
スタックトレースと関係する 2 つのファイルを貼り付け、最小の修正パッチと失敗の原因を Hydrogen に尋ねます。
エージェントを 1 手ずつ動かす
関数の一覧をモデルに渡し、要求された呼び出しを実行して結果を返します。手順数の上限は自分のコード側で管理します。
サポートでスクリーンショットを読む
エラー画面のスクリーンショットを添付し、原因となった設定と次に試すべき操作を尋ねます。
プロンプトガイドと実践のヒント
低いレベルから始める
まず low か medium を試し、回答に抜けがあるときだけ上げます。高いレベルほど応答の前に多くの出力トークンを使います。
思考の分も予算に入れる
思考の分も
max_tokensから差し引かれます。数十トークンの上限では本文が出る前に使い切ることがあるため、十分な余裕を持たせます。変わらない内容を先頭に置く
指示や長い参考資料は会話の先頭に置きます。繰り返し送る先頭部分には、キャッシュ入力の低い料金が適用される場合があります。
Gemini 4 Hydrogen は、日常のコーディングとエージェント処理に向けた Google の高速推論モデルです。
google/gemini-4-hydrogen/chat — /v1/chat/completions
reasoning_effort には low、medium、high、xhigh を指定します。思考は max_tokens を消費するため、本文の分も残してください。
画像は image_url パーツで添付し、関数は tools で宣言します。スキーマに沿った JSON は response_format で指定できます。
Hydrogen へのリクエストには Google の安全システムが適用されるため、一部のプロンプトは拒否されることがあります。
API クイックスタート
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "google/gemini-4-hydrogen/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。













