はじめに
複雑なソフトウェア設計と深い分析作業に向けた Google Gemini 4 の主力推論モデル。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | テキスト |
| 開発元 | |
| モデル ID | google/gemini-4-neon/chat |
| 公式発表日 | 2026 年 11 月 18 日 |
| API 形式 | OpenAI 互換 /v1/chat/completions(同期応答および SSE ストリーミング対応) |
| コンテキストウィンドウ | プロンプト・画像・内部思考・応答で共有する 1,048,576 トークン |
| 出力上限 | 1 ターンあたり 65,536 トークン(内部思考トークンを含む。既定値 4,096) |
| 思考強度 | low、medium、high(既定)、xhigh(low、medium、high は本番疎通確認済み) |
| 対応モダリティ | テキストおよび |
| 現在の SpicyAPI 料金 | 入力 $2.10 / 1M・キャッシュ入力 $0.105 / 1M・出力 $10.50 / 1M |
| コンテンツポリシー | Google 標準のモデレーションを適用(制限なしティア対象外・拒否時は $0) |
主な機能とハイライト
Gemini 4 Hydrogen を上回る深い統合分析
Google は Gemini 4 Neon を Hydrogen の上位に位置づけており、高速な日常ループを超える業務に最適です。サービス横断のリファクタリング、長編原稿の整合性チェック、高密度な分析メモの作成を単一の 1,048,576 トークン枠内で完結できます。
1 つのエンドポイントで思考深度を柔軟に調整
クライアント URL やモデルスラッグを変えずに、素早い一次仕分け向けの low から、複合制約の検証や難解なデバッグに適した medium、high、xhigh まで reasoning_effort を段階的に切り替えられます。
ネイティブ JSON Schema と関数呼び出しを両立
response_format の厳密な JSON Schema 制約と、tools 内の最大 128 件のツール定義を組み合わせられます。後段パーサーやエージェント制御基盤、制作進行トラッカーへ安定したペイロードを返しつつ、実運用のツール連携も同時に進められます。
コードと並べてレイアウトや参考静止画を精査
user メッセージ内に image_url フレームを直接添付すれば、ダークモード UI のキャプチャや絵コンテ、システム構成図をソースファイルや仕様書、編集ガイドラインと 1 ターンで突合できます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
messages | はい | Google の Gemini 4 Neon API は、1,048,576 トークンの共有コンテキストと 4 段階の思考制御で大規模設計・調査分析・ツール連携を担います。 1 件以上 · 256 件以内 |
max_tokens | いいえ | 65,536 トークン(思考含む) |
reasoning_effort | いいえ | low / medium / high / xhigh |
stop | いいえ | 1–4 1 文字以上 · 1 件以上 · 4 件以内 |
temperature | いいえ | 0–2 |
top_p | いいえ | 0.01–1 |
tools | いいえ | ツール呼び出し・JSON スキーマ対応 128 件以内 |
parallel_tool_calls | いいえ | true / false デフォルト値: |
tool_choice | いいえ | auto / none / required |
response_format | いいえ | JSON / JSON Schema |
料金
入力 $2.10 / 出力 $10.50 100 万トークンあたり
ユースケース
サービス横断のリファクタリングと移行監査
TypeScript の型定義、データベース移行ファイル、失敗した結合テストログを 1M トークンのコンテキストへまとめて読み込み、段階的な展開手順とエッジケースの注意点を洗い出せます。
UI ビジュアルとアートディレクションの講評
ランディングページの画面キャプチャやムードボード画像を image_url で渡し、デザイントークンと照らし合わせながらコントラスト比、視線誘導、夜の雰囲気の一貫性を確認できます。
長文ブリーフからの厳密な JSON 抽出
長大なキャンペーン企画書、法務メモ、技術 RFC を壊れやすい正規表現に頼らず、response_format を通じてスキーマ検証済みの JSON レコードへ変換できます。
多段階エージェントと制作スタジオのツール連携
tools に最大 128 個の関数を定義しておけば、Neon が整合性台帳の参照やデータベース検索、制作上の齟齬報告を行い、承認済みの各手順をバックエンド側で実行できます。
長編ストーリーと会話の継続改稿
冒頭メッセージに全話の設定資料、衣装ルール、キャラクターの口調シートを固定しておくことで、キャッシュ入力料金の恩恵を受けながら章をまたぐ緊張感やテンポを磨き上げられます。
プロンプトガイドと実践のヒント
OpenAI 互換のチャットリクエストを送信
model に google/gemini-4-neon/chat を指定し、system、developer、user、assistant、tool の順にメッセージを並べて /v1/chat/completions へ POST します。必要に応じて SSE ストリーミングも利用できます。
内部思考分を見込んで
max_tokensを設定Gemini 4 では内部推論トークンも
max_tokensに算入され出力単価で課金されるため、希望する表示文字数より十分に余裕を持たせてください。medium や high では 2,048 以上からの設定をおすすめします。不変のプレフィックスを先頭に配置
固定のシステム指示、スキーマ、スタイルガイド、リポジトリ文脈を messages の冒頭にまとめることで、継続ターンに $0.105 / 1M のキャッシュ入力単価が適用されやすくなります。
temperature ではなくスキーマで出力を制御
Google の仕様上、Gemini 4 はカスタムの temperature や
top_p指定を無視します。安定した出力構造はresponse_formatの JSON Schema で担保し、課題の難易度に応じてreasoning_effortを調整してください。
概要
Google Gemini 4 Neon(google/gemini-4-neon/chat)は、2026 年 11 月 18 日に発表された Google のミドル〜フロンティア向け推論モデルです。Gemini 4 Hydrogen の上位に位置づけられ、複数ファイルにまたがるソフトウェア開発、高密度な分析統合、画面レイアウト監査、構造化エージェント基盤に適しています。呼び出しは SpicyAPI の OpenAI 互換 /v1/chat/completions エンドポイント経由で行い、同期 JSON 応答と SSE ストリーミングの双方に対応します。
2026 年 11 月 19 日の実機検証では、システムプロンプト、関数呼び出し(tools)、厳密な JSON Schema 出力(response_format)、および可変の reasoning_effort(low、medium、high)の動作を確認しています。
パラメータ
| パラメータ | 型 | 既定値 | 範囲・補足 |
|---|---|---|---|
messages | array(必須) | — | 1〜256 件の時系列ターン(system、developer、user、assistant、tool)。user にはプレーンテキストまたは text と image_url の混在パートを指定可能 |
max_tokens | integer | 4096 | 1〜65536。内部思考トークンと可視出力で共有するため、medium や high では 2048 以上を推奨 |
reasoning_effort | string | "high" | "low"、"medium"、"high"、"xhigh"。応答前の思考深度を制御(low・medium・high を実機確認済み) |
response_format | object | — | {"type":"json_object"} または厳密な {"type":"json_schema","json_schema":{...}} 出力を指定 |
tools | array | — | モデルから呼び出せる OpenAI 形式の関数定義を最大 128 件まで登録可能 |
tool_choice | string / object | "auto" | "auto"、"none"、"required"、または特定の関数名オブジェクト |
parallel_tool_calls | boolean | true | 1 ターン内での複数ツール同時呼び出しを許可 |
stop | string / array | — | 任意の停止文字列、または最大 4 件の文字列配列(各最大 32 文字) |
temperature | number | — | SDK 互換のため 0〜2 を受理。Google 公式仕様により Gemini 4 はサンプリング上書きを無視 |
top_p | number | — | SDK 互換のため 0.01〜1 を受理。Google 公式仕様によりニュークリアス上書きを無視 |
料金とコスト試算
SpicyAPI は完了した呼び出しの実測トークン数を、Google 公式定価の 30% オフで精算します。
| トークン種別 | SpicyAPI 単価(1M あたり) | Google 公式定価(1M あたり) |
|---|---|---|
| 標準入力 | $2.10 | $3.00 |
| キャッシュ入力 | $0.105 | $0.15 |
| 出力(応答+思考) | $10.50 | $15.00 |
具体的な試算例
- 非キャッシュの設計レビュー: 入力 40,000 トークン+出力 4,000 トークン(思考込み)=
$0.084 + $0.042= $0.126 - キャッシュ活用の複数ターン作業: キャッシュ先頭 120,000 トークン+新規入力 3,000 トークン+出力 2,500 トークン =
$0.0126 + $0.0063 + $0.02625= $0.04515 - 短時間の構造化抽出(
reasoning_effort: "low"): 入力 6,000 トークン+出力 600 トークン =$0.0126 + $0.0063= $0.0189
内部推論トークンは出力単価として集計されます。失敗した呼び出しやモデレーションによる拒否は $0 です。
ツール連携・JSON Schema・プロンプトキャッシュ
- 厳密な JSON 出力:
temperature=0に頼るのではなく、response_formatへjson_schemaオブジェクトを渡してください。保存前にアプリケーション側でもパース結果を検証するのが安全です。 - 関数呼び出しループ:
toolsにスキーマを宣言し、返されたtool_callsを検査してローカルで承認済み処理を実行したのち、一致するtool_call_idを付けたrole: "tool"メッセージを返送します。 - キャッシュヒット率の最大化: Google は暗黙的コンテキストキャッシュを採用しています。変更しないシステム指示、スキーマ、スタイル資料、リポジトリスナップショットを厳密に
messagesの冒頭へ固定すれば、後続ターンの入力単価を 1M あたり$2.10から$0.105へ引き下げられます。
Neon・Hydrogen・Claude Fable 5.2 の選び分け
| モデル | コンテキスト / 最大出力 | 思考制御 | 構造化 JSON | 主な適性 |
|---|---|---|---|---|
| Gemini 4 Neon | 1,048,576 / 65,536 | low、medium、high、xhigh | ネイティブ response_format+tools | 複数ファイル改変、画面監査、厳密 JSON 抽出、$2.10 / $10.50(1M)のミドル〜フロンティア推論 |
| Gemini 4 Hydrogen | 1,048,576 / 65,536 | low、medium、high、xhigh | ネイティブ response_format+tools | 高頻度な日常修正と高速エージェント処理。Google 定価は Neon の半額(最新の SpicyAPI 単価はモデルページ参照) |
| Claude Fable 5.2 | 1,000,000 / 128,000 | low、medium、high、xhigh、max | tools+tool_choice 経由 | 64K 超の単一ターン出力や 5 段階の適応推論が必要な案件(最新の SpicyAPI 単価はモデルページ参照) |
制限事項とコンテンツポリシー
- 直接対応モダリティ: テキストと
image_urlパートを直接受理します。PDF、音声、動画は送信前にテキスト抽出またはページ画像化を行ってください。 - ターン上限: 応答は内部思考と可視テキストの合算 65,536 トークンで終了します。Google のバックグラウンド長文デコード継続モードは公開していません。
- モデレーション: Gemini 4 Neon は SpicyAPI の制限なしティアには含まれません。すべてのプロンプトに 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-neon/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 リファレンスを参照してください。













