著者注:同じ Gemini 4 Neon でも、Gemini API の告知と Antigravity のモデルドキュメントでは、示されるコンテキストウィンドウが異なります。この記事では入口ごとに2つの数字を分けて整理し、エージェント設計にウィンドウの数字を書く前の確認手順を示します。
エージェントを構築するチームは、宣伝ページ上のコンテキストウィンドウをそのまま設計に書き込みます。たとえば「Neon は 1M をサポートしているので、コードリポジトリ全体を一度に詰め込める」といった書き方です。しかし Gemini 4 Neon の世代では、この書き方が問題を引き起こしやすくなります。Gemini API の告知には 1,048,576トークン、Antigravity のモデルドキュメントには最大 512Kトークンと書かれており、どちらの数字も Google から同じ週に公開されています。しかも両方のページは互いを参照していません。
これはどちらかが間違っているわけではありません。これらは2つの異なる呼び出しサーフェスを説明しています。1つはモデルを直接呼び出す API、もう1つは Antigravity 内のエージェント入口です。設計にどちらの数字を書くべきかは、リクエストが実際にどちらの入口から送信されるかによって決まります。
この記事の核心:読み終えると、Gemini 4 Neon の2つのウィンドウ数字がそれぞれどこから来ているのかが分かります。さらに「まず入口を確認し、次に思考レベルを見て、最後にウィンドウを書く」という確認手順も身につきます。この順序で進めれば、512K しか与えられない入口に対して 1M で計画を立ててしまうことはありません。

Gemini 4 Neon コンテキストウィンドウの核心ポイント
まず、参考資料から確認できる事実を1つの表にまとめます。表中の数字はすべて各ドキュメントの原文であり、推測やテスト結果ではありません。
| 要点 | ドキュメント原文 | プランへの意味 |
|---|---|---|
| Gemini API のウィンドウ | Google 2026-11-18 の発表:Neon の統一コンテキスト 1,048,576 token |
API を直接呼び出す際の計画上限 |
| Antigravity のウィンドウ | Antigravity モデルドキュメント:Gemini 4 Neon のコンテキストは最大 512K token |
Antigravity で Agent を動かす際の計画上限 |
| 思考レベル | Antigravity のドキュメントには Low、Medium、High(デフォルト)、Extra が記載 | デフォルトが High なので、まず確認してから見積もる |
| 2つのドキュメントの関係 | 同じ週に公開され、ページ同士の相互参照はない | 一方の数字から他方を推測することはできない |
| API の価格 | 入力 $3、キャッシュ入力 $0.15、出力 $15(100万トークンあたり) |
コスト見積もりは API の入口を基準にする |
Gemini 4 Neon の2つの数字がどちらも正しい理由
1M と 512K はどちらも Google 公式の数字で、単に別々のページに書かれているだけです。Gemini API の発表が指しているのはモデルの API 上の統一コンテキストで、原文は 1,048,576 token です。Antigravity モデルドキュメントが指しているのは、Neon が Antigravity という製品内で使えるコンテキストで、原文は「最大 512K token」です。2つのページはそれぞれ別の側面を述べており、どちらも成立するので、矛盾はありません。
OrcaRouter は 2026-11-19 の記事で、この差異をわざわざ指摘しています。記事ではさらに、ソーシャルメディアのユーザー @kimmonismus が 11月18日にツール呼び出しの記録を投稿したことにも触れています。ただしこれは第三者の投稿であり、Google によるウィンドウの説明ではないため、ウィンドウ仕様として引用することはできません。プランを書く際は、ウィンドウの数字は Google 自身のドキュメントページのみを根拠とし、どのページなのかを明記してください。
Gemini 4 Neon と同じシリーズのモデルのウィンドウを混同しない
もう1つの落とし穴は、モデルをまたいで数字を使い回してしまうことです。Gemini 4 Carbon のモデルページにもコンテキストは 1,048,576 と書かれていますが、それは Carbon の API 上のウィンドウであり、Antigravity 内の Neon に当てはめることはできません。同様に、Neon の API ウィンドウも Antigravity の Neon に直接当てはめることはできません。数字はモデルと入口という2つの次元で同時に一致している必要があり、どちらか一方だけでは確認完了とはなりません。

Gemini 4 Neon の2つの入口を比較
以下の表で、2つの入口を分けて見てみましょう。表中の「計画のアドバイス」列は、プランを書く際の実践的なアドバイスであり、ドキュメントの仕様ではありません。
| 観点 | Gemini API(OpenAI互換の集約インターフェースを含む) | Antigravity |
|---|---|---|
| コンテキストウィンドウの原文 | 1,048,576 token(Googleの公告) |
最大 512K token(モデルドキュメント) |
| 出典 | Gemini API / Google 2026-11-18 公告 | antigravity.google/docs/models |
| 思考レベル | APIドキュメントのパラメータに準拠 | Low、Medium、High(デフォルト)、Extra |
| 課金方式 | token単位の課金、キャッシュ入力価格あり | Antigravityの製品ルールに準拠 |
| 計画のアドバイス | 単一リクエストは長いコンテキストで設計できるが、余裕を残すこと | 512Kで設計し、長いタスクは分割と圧縮を行う |
API入口の比較分析:APIを直接呼び出すとコンテキストウィンドウがより大きくなり、大量のドキュメントや長いログ、コード全体を一度に投入して分析するのに適しています。ただし、ウィンドウが大きいからといって毎回満杯にする必要はなく、入力が長くなるほどコストと遅延が増加します。それに対して、APIを「長い資料を一度に読み込む」入口としてとらえ、キャッシュ入力価格を組み合わせれば、オフラインバッチ処理や検索後の大規模な分析に適しています。
Antigravity入口の比較分析:Antigravityはエージェントのワークフロー向けで、ドキュメントに示されているコンテキストウィンドウは最大512Kです。エージェントは複数ラウンドのツール呼び出しで履歴を絶えず蓄積するため、実際に利用可能なスペースは単一リクエストよりも早く消費されます。Antigravityで長いタスクを実行するチームは、512Kを前提に分割・要約・コンテキスト淘汰の戦略を設計する方が安全で、1Mで見積もらないようにしましょう。

Gemini 4 Neon のAntigravityにおける思考レベル
Antigravityのドキュメントには4つの思考レベルが記載されており、デフォルトはHighです。デフォルト値に気づかず、ウィンドウの上限をそのまま予算の基準にしてしまう人も少なくありません。以下の表はレベル別に整理した計画のアドバイスです。レベル名とデフォルト値はドキュメントに基づくもので、アドバイス部分は一般的な実践方法です。
| 思考レベル | ドキュメントの表記 | 計画のアドバイス |
|---|---|---|
| Low | 任意選択 | 短いチェーン、確実性の高いツール呼び出しに適する |
| Medium | 任意選択 | 通常のコーディングと多段階検索に適する |
| High | デフォルト | 設定を変更しなければこのレベル。見積もりはこれを基準にする |
| Extra | 任意選択 | 難問に適する。より多くの余裕と待ち時間を確保する |
思考レベルは推論コストと応答時間に影響します。コンテキストと課金への具体的な計上方法は、Antigravityのドキュメントに準拠します。確認する際は、まずチームが実際に使用しているレベル、特にデフォルトのHighを確かめてから、各ラウンドで履歴記録と検索資料に残せるスペースを決めましょう。
Gemini 4 Neon クイックスタート
ステップ1:どのサーフェスを呼び出しているかを確認する
まず、次の問いに答えてください。リクエストは一体どこから送信されるのでしょうか。コード内で SDK を通じてリクエストを送る場合、あなたは API サーフェスを利用しており、ウィンドウは 1,048,576 を前提に計画します。Antigravity の中で Agent に作業をさせる場合、あなたは Antigravity サーフェスを利用しており、ウィンドウは最大 512K を前提に計画します。1つのプロジェクトでこの両方を使う場合は、計画書を2つのセクションに分けて書いてください。1つの数字にまとめてはいけません。
ステップ2:OpenAI互換インターフェースでリクエストを1回送ってみる
APIサーフェス経由で呼び出す場合は、APIYIのOpenAI互換インターフェースを通じてNeonを利用できます。モデルIDは gemini-4-neon です。最小構成の呼び出しに必要な設定は3か所だけです。
- クライアントを作成:
client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1") - モデルを指定:
model="gemini-4-neon" - メッセージを送信:
client.chat.completions.create(model="gemini-4-neon", messages=[{"role": "user", "content": "总结这份日志"}])
レスポンスが返ってきたら、response.usage.prompt_tokens と response.usage.completion_tokens を読むことで、その回の実際の消費量がわかります。コンテキストウィンドウを設計するときは、この戻り値を基準にしてください。文字数からの概算には頼らないようにしましょう。
分割呼び出しの考え方(全体像)を見る
長い資料が自分で設定した1回あたりの予算を超える場合は、次の流れで分割するとよいでしょう。
1. 初期化:`client = OpenAI(api_key=”YOUR_API_KEY”, base_url=”https://api.apiyi.com/v1″)`
2. 予算を設定:APIサーフェス側では `budget = 1048576 * 0.7` を設定できます。同じロジックをAntigravity側でも使い回す場合は、512Kの7割で設定し直してください
3. 資料を分割:ドキュメントを章やファイル単位で `chunks` に分け、各チャンクをまず `usage.prompt_tokens` で試験的に1回実行し、実際の長さを記録します
4. 順番に要約:各チャンクに対して `model=”gemini-4-neon”` を呼び出し、固定フォーマットの要約を出力させます
5. 統合して推論:すべての要約を新しい `messages` にまとめ、もう一度まとめや意思決定を行います
6. 使用量を記録:各ラウンドで `prompt_tokens`、`completion_tokens` をログに書き込み、後からコストを照合できるようにします
予算における7割というのはあくまで余裕を残すための経験的な目安であり、ドキュメントに規定されたものではありません。タスクに応じて調整してください。
🚀 クイックスタート:設計に入る前に、まずAPIYI apiyi.com で登録して無料のテスト枠を受け取り、
gemini-4-neonで実際の資料を1回処理してみましょう。usageの戻り値を取得したうえで、コンテキストウィンドウの予算を決めると安心です。
ステップ3:モデル名と価格を確認する
価格を確認する入口は2つあります。APIYI のモデル一覧表 https://docs.apiyi.com/models.md と、価格API https://api.apiyi.com/api/pricing です。2026-11-20 に確認した時点で、一覧表の最終更新は 2026-11-19 10:59(UTC+8)で、その版にはまだ gemini-4-neon が掲載されていませんでした。一方、価格API(バージョン shell-api-modelmak-v1)にはすでにこのモデルが含まれています。Neon の価格を確認するときは、価格APIを優先してください。
価格APIでは、model_ratio が 1 の場合が入力 $2/100万トークンに対応します。gemini-4-neon は model_ratio が 1.5、completion_ratio が 5、cache_ratio が 0.05 なので、換算すると入力 $3、出力 $15、キャッシュ読み取り $0.15 となり、Google の定価と一致します。
| モデル | 入力($/100万トークン) | キャッシュ読み取り | 出力 | 備考 |
|---|---|---|---|---|
gemini-4-neon |
3 |
0.15 |
15 |
Google の定価と一致、価格APIを優先 |
gemini-4-carbon |
2 |
0.1 |
10 |
Google の 2026-11-30 までの紹介価格に対応 |
gemini-4-hydrogen |
1.5 |
0.075 |
7.5 |
価格API |
gemini-4-argon |
2 |
0.1 |
10 |
モデル一覧表 |
| 利用可能なプラットフォーム | APIYI、Google 公式 API | — | — | 呼び出しURL https://api.apiyi.com/v1 |
Carbon については、気をつけるべき時期があります。12月1日以降の Google の標準価格は入力 $4、出力 $20 で、紹介価格は 2026-11-30 までです。月をまたぐコスト予算は、2つの期間に分けて計算する必要があります。
💡 選び方のヒント:同じタスクをまず
gemini-4-neonとgemini-4-hydrogenでそれぞれ一度実行し、結果とusageを比較してみましょう。APIYI は統一された OpenAI 互換インターフェースを提供しており、モデルを切り替えるときはmodelパラメータを変更するだけです。
Gemini 4 Neon のコンテキスト予算を計画書にどう書き込むか
入口と思考レベルを確認したら、ウィンドウの数値を計画書に書き込めます。以下では、一般的な Agent タスクごとに計画の考え方を示します。表の「推奨戦略」はエンジニアリング上の実践であり、ドキュメントの仕様ではありません。
| タスク種別 | 入口 | 計画上限(ドキュメント原文) | 推奨戦略 |
|---|---|---|---|
| リポジトリ全体のコード分析 | API | 1,048,576 token |
まず関連ファイルを検索し、その後まとめて投入する。余裕を残す |
| 長いログの障害調査 | API | 1,048,576 token |
時間ウィンドウで分割し、繰り返し現れるプレフィックスはキャッシュ入力を使う |
| IDE 内での多段リファクタリング | Antigravity | 最大 512K token |
定期的に履歴を要約し、古いツール出力を破棄する |
| マルチツール Agent の長時間タスク | Antigravity | 最大 512K token |
サブタスクに分割し、各セグメント終了時に構造化メモリを書く |
| 入口をまたいだ同一フローの再利用 | 両方 | 512K を共通上限とする |
小さいウィンドウ向けに設計し、API 側でもそのまま実行できるようにする |
最後の行は最も見落とされやすいところです。同じ Agent ロジックを Antigravity でも実行し、API 経由でも実行する場合、最も堅実な方法は 512K を前提に共通フローを設計することです。そうすれば API 上でもそのまま動作し、ウィンドウを使い切らないだけです。逆に 1M 前提で設計すると、Antigravity に移ったときに分割ロジックを書き直す必要があります。
計画書にウィンドウの数値を書くときは、「数値 + 出典 + 入口」の形式をおすすめします。たとえば「Antigravity モデルドキュメント:Gemini 4 Neon 最大 512K token、デフォルトの思考レベル High」です。レビュー時にこの数値がどのサーフェス(入口)に対応するか一目でわかり、後続のドキュメント更新時にも項目ごとに確認しやすくなります。

よくある質問(FAQ)
Q1:Gemini 4 Neon のコンテキストは結局どのくらいの長さですか?
入口次第です。Gemini API / Google の 2026-11-18 のお知らせには統一コンテキスト `1,048,576` token と書かれています。一方、Antigravity のモデルドキュメントには最大 `512K` token と書かれています。どちらも Google の原文であり、それぞれ異なる呼び出しサーフェスに対応しています。
Q2:API の 1M と Antigravity の 512K は矛盾していますか?
矛盾しません。2 つのドキュメントは異なる製品サーフェスを説明しており、同じ週に公開されたものの、ページ同士が互いを参照していません。矛盾が生じるのはプランの場面だけです。API の数字を使って Antigravity 内のタスクを計画すると、問題が起きます。
Q3:ネット上で誰かが貼り付けたツール呼び出し記録は、ウィンドウの根拠にできますか?
できません。OrcaRouter の 2026-11-19 の記事によると、@kimmonismus が 11 月 18 日に貼り付けたツール呼び出し記録は第三者の投稿であり、Google のウィンドウ説明ではありません。ウィンドウの数字は Google のお知らせとドキュメントページのみを引用します。
Q4:Carbon も 1,048,576 なので、Antigravity の Neon に当てはめてよいですか?
できません。Carbon のモデルページにある `1,048,576` は Carbon の API ウィンドウです。モデルが異なり、入口も異なり、2 つの次元がどちらも一致しません。Antigravity 内の Neon は、引き続きモデルドキュメントの最大 512K で計画してください。
Q5:API 経由で Gemini 4 Neon を素早く呼び出すには?
1. APIYI apiyi.com で登録し、APIキーと無料テスト枠を取得します
2. SDK の `base_url` を `https://api.apiyi.com/v1` に設定します
3. モデルに `gemini-4-neon` を入力し、`usage` フィールドを読んで実際の消費量を確認します
こうすると API サーフェス経由になり、ウィンドウは Google のお知らせの `1,048,576` token で計画します。
Q6:モデル一覧に gemini-4-neon が見つからない場合、価格はどこを基準にしますか?
価格インターフェースを基準にします。一覧の 2026-11-19 の版にはまだこのモデルが掲載されていませんが、価格インターフェースにはすでに登録されており、換算結果は入力 `$3`、キャッシュ読み込み `$0.15`、出力 `$15` で、Google の表示価格と一致しています。確認が必要なときは、APIYI apiyi.com の価格インターフェースを直接照会すればよいです。
Q7:Antigravity のデフォルトの思考レベルは計画に影響しますか?
影響します。ドキュメントにはデフォルトが High と明記されており、設定を変えなければこのレベルで動作します。思考レベルは推論コストと応答時間に影響するため、予算は実際に使用するレベルで見積もる必要があります。具体的な計上方法は Antigravity のドキュメントに従います。
Q8:Gemini 4 Neon にはどのような注意すべき制限がありますか?
– ウィンドウは入口によって異なり、汎用の数字は存在しません
– 長い入力はコストと遅延を押し上げます。ウィンドウが大きくても、毎回満杯にする必要はありません
– ドキュメントは更新される可能性があるため、プラン内の数字には出典と確認日を明記してください
Gemini 4 Neon の重要ポイント Key Takeaways
- 2つの数値はいずれも公式の原文:API の告知では
1,048,576token、Antigravity のドキュメントでは最大 512K token - 数字を書く前に入口を確認:リクエストがどのサーフェスから発信されるかで、引用するドキュメントを決める
- デフォルトの思考レベルは High:Antigravity は設定を変えなければ High になり、予算はそれを前提に見積もる
- 第三者の投稿は仕様ではない:ツール呼び出しの記録は、Google のウィンドウに関する説明の代わりにはならない
- モデルごとのウィンドウは流用できない:Carbon の API ウィンドウを Antigravity の Neon に当てはめることはできない
- 入口をまたぐ再利用は小さいウィンドウに合わせる:両方で動かすフローは、一律 512K を前提に設計する
- 価格は料金エンドポイントで確認:APIYI 経由で
gemini-4-neonを呼び出し、usageフィールドで予算を調整する
まとめ
Gemini 4 Neon のコンテキスト設計における核心ポイント:
- 入口がウィンドウを決める:API サーフェスは
1,048,576token、Antigravity サーフェスは最大 512K token と、それぞれ出典を明記する - 確認の順序は固定:まず入口を確認し、次に思考レベルのデフォルト値を確認し、最後にウィンドウの数値を計画に書き込む
- 実際の使用量で調整する:返却される
usageを基準にし、分割・要約・入力キャッシュを組み合わせてコストを抑える
エージェントの設計を書くときは、「数値 + 出典 + 入口」をひとまとまりとして書くようにすれば、512K しか与えられない入口を 1M で計画してしまう事態を避けられます。APIYI apiyi.com 経由で gemini-4-neon に実際の資料を流して使用量データを取得し、それから最終稿を固めるのがおすすめです。プラットフォームでは無料枠と複数モデル向けの統一インターフェースが提供されています。
📚 参考資料
-
Gemini API / Google の発表(2026-11-18):Gemini 4 Neon の統一コンテキストと API 料金
- 説明:
1,048,576token のウィンドウ、および入力・キャッシュ入力・出力の価格に関する一次情報源です
- 説明:
-
Antigravity モデルドキュメント:Antigravity における Gemini 4 Neon のコンテキストと思考レベル
- リンク:
antigravity.google/docs/models - 説明:最大 512K token と、Low・Medium・High(デフォルト)・Extra の思考レベルの出典です
- リンク:
-
OrcaRouter の記事(2026-11-19):2つのドキュメント間でウィンドウの数値が異なる点を指摘
- 説明:あわせて、サードパーティ製ツールの呼び出し記録をウィンドウの説明として扱うことはできないと述べています
-
APIYI のモデル一覧と価格API:型番と価格を照合する入口
- 説明:前述の「ステップ3:型番と価格の確認」に記載した2つのアドレスを参照してください。
gemini-4-neonは価格APIを基準とします
- 説明:前述の「ステップ3:型番と価格の確認」に記載した2つのアドレスを参照してください。
作者:APIYI 技術チーム
技術交流:APIYI のウェブサイトトップページからお問い合わせください。その他の資料は docs.apiyi.com ドキュメントセンターでご覧いただけます
