本文へスキップ

google/gemini-4-hydrogen/chat

Google の Gemini 4 Hydrogen チャットエンドポイントは、日常のコードとエージェント処理を担い、テキストと画像を受け付けます。思考レベルは 4 段階、共有コンテキストは 1,048,576 トークンです。

入力 $1.3247出力 $6.6233100 万トークンあたりキャッシュ入力 $0.0662

プレイグラウンド

リクエストを送信

クイックスタート

例は、選択中のエンドポイントの公開パラメーター定義から作っています。API キーとサンプル素材を差し替えて、ご自身のサーバーから送信してください。

SDK・連携
POSThttps://api.spicyapi.ai/v1/chat/completions

API 認証

API キーはサーバーの環境変数 SPICY_API_KEY に保存します。Bearer 認証を使用し、JSON リクエストには Content-Type: application/json を指定してください。

Authorization: Bearer $SPICY_API_KEY
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 はどのリクエストも、同じスキーマで検証します。

同じ論理リクエストには同じ Idempotency-Key を使い続けてください。通信が切れた場合は新しいキーで自動再送せず、受理済みリクエストを追跡できるよう request_id を保存します。冪等性は、過去のチャットストリームを再生するものではありません。

入力パラメーター

モデルのパラメーターは、JSON リクエスト本文の model と同じ階層に指定します。このエンドポイントでは input でラップしません。

messagesarray<object>必須

Hydrogen との会話を古い順に並べます。ユーザーメッセージにはテキストと image_url のパーツを混在できます。

デフォルト値
指定なし
制約
minItems:1
maxItems:256
response_formatobject任意

Hydrogen に JSON を要求します。独自の json_schema も指定できます。コードで使う前に結果を検証してください。

デフォルト値
指定なし
tool_choicestring | object任意

このターンで Hydrogen が関数を呼び出せるかを指定します。auto、none、required、または特定の関数を選べます。

デフォルト値
指定なし
parallel_tool_callsboolean任意

false を指定しない限り、Hydrogen は 1 ターンで複数の関数を要求できます。何を実行するかは引き続きアプリケーションが判断します。

デフォルト値
true
toolsarray<object>任意

Hydrogen が呼び出しを要求できる関数で、最大 128 件定義できます。引数の確認と処理の実行はアプリケーションが行います。

デフォルト値
指定なし
制約
maxItems:128
top_pnumber任意

Hydrogen はクライアントとの互換性のために 0.01 から 1 までの値を受け付けます。Google のドキュメントによると、この値も無視されます。

デフォルト値
指定なし
制約
minimum:0.01
maximum:1
temperaturenumber任意

Hydrogen はクライアントとの互換性のために 0 から 2 までの値を受け付けます。Google のドキュメントによると範囲内の値は無視されるため、応答は変わりません。

デフォルト値
指定なし
制約
minimum:0
maximum:2
stopstring | array任意

1 つ、または最大 4 つの文字列を指定します。Hydrogen は最初に一致した箇所の直前で応答を終え、一致した文字列は返しません。

デフォルト値
指定なし
制約
minLength:1
minItems:1
maxItems:4
reasoning_effortstring任意

Hydrogen が応答前に考える深さです。low、medium、high、xhigh から選びます。既定は high で、高いほど出力トークンを多く使います。

デフォルト値
"high"
使用可能な値
"low""medium""high""xhigh"
max_tokensinteger任意

Hydrogen の応答枠で、1 から 65,536 まで指定できます(既定は 4,096)。思考もこの枠を使うため、小さすぎると本文が出る前に終了します。

デフォルト値
4096
制約
minimum:1
maximum:65536

結果を取得

stream が false の場合、完成したチャット応答が直接返ります。choices[].message を読み取ってください。タスクのポーリングは不要です。Server-Sent Events 対応のクライアントでは stream を true にできます。

完了レスポンスの例
{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "google/gemini-4-hydrogen/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

レスポンス例は構造を示すためのものです。usage はトークン数を示し、実際のトークン数と料金はリクエスト内容によって変わります。

SDK・連携

アプリ、ターミナル、AI アシスタント、ビジュアルワークフローで SpicyAPI を活用。接続ガイドを選んでください。

SillyTavern やロールプレイアプリで使う

SillyTavern、RisuAI、Agnai など OpenAI 互換の設定があるアプリに、下のベース URL と API キーを貼り付け、モデルに google/gemini-4-hydrogen/chat を選んでください。ブラウザーからの呼び出しにも対応しており、このモデルが受け付けないスライダーはエラーにならず無視されます。

Base URL: https://api.spicyapi.ai/v1
Model: google/gemini-4-hydrogen/chat

ComfyUI で使う

ComfyUI Manager か下のコマンドで SpicyAPI ノードをインストールしたら、SpicyAPI Chat ノードで google/gemini-4-hydrogen/chat を選ぶと、ComfyUI のグラフの中でこのモデルを使えます。

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi