Gemini 4 Neon APIの使い方を徹底解説

Gemini 4 Neon APIは、InteractionsエンドポイントでモデルID「gemini-4-neon」を使用します(有料 tiers のみ)。このガイドでは、最初のリクエストの送信方法、他のGemini 4モデルからの移行、64Kトークン超えの生成、NeonとHydrogenの組み合わせ、コストの削減方法を解説します。

Medy Evrard

19 11月 2026

Gemini 4 Neon APIの使い方を徹底解説

Apidog エンタープライズ

オンプレミスデプロイ

SSO & RBAC

SOC 2 準拠

Apidog Enterpriseを見る

Gemini 4 Neon APIでは、モデルIDにgemini-4-neonを使用します。https://generativelanguage.googleapis.com/v1beta/interactionsに対してPOSTリクエストを送り、キーをx-goog-api-keyヘッダーに、modelとinputをJSONボディに含めて呼び出します。有料ティアのみで利用可能で、料金は入力100万トークンあたり3ドル、出力100万トークンあたり15ドル、デフォルトのthinkingレベルはhighです。

このガイドでは、Neonの特徴である以下の点を解説します。有料ティアの設定、他のGemini 4モデルからの切り替え、64Kトークンを超える出力、NeonとHydrogenの組み合わせ、コスト管理の方法です。すべてのフィールド名はGoogleのドキュメントに基づいています。

最初のGemini 4 Neon API呼び出しの前に必要なものは?

必要なのは、課金設定済みプロジェクトのGemini APIキー、モデルIDgemini-4-neon、そしてInteractionsエンドポイントです。Googleは2026年11月18日にNeonをリリースしました。Gemini 4ファミリーの中間モデルとして、HydrogenとCarbonの間に位置します。

項目 値
モデルID gemini-4-neon
エンドポイント generativelanguage.googleapis.com上のPOST /v1beta/interactions
認証ヘッダー x-goog-api-key: $GEMINI_API_KEY
API Interactions APIとgenerateContent
Thinkingレベル low、medium、high(デフォルト)、xhigh
コンテキストウィンドウ 1,048,576トークン(入力・thinking・出力で共有)
同期リクエスト1回あたりの出力 65,536トークン
ロングデコード 最大1,048,576トークンから入力分を引いた値まで
無料ティア なし
有料価格 入力$3.00/1M、出力$15.00/1M(thinkingを含む)
キャッシュ済み入力 暗黙的キャッシュにより$0.15/1M

PDF、関数呼び出し、ストリーミングについては、リクエストの形式はGemini 4 Hydrogen APIガイドと同じです。モデルIDだけを入れ替えてください。

Neonで使えるGemini APIキーを取得するには?

Neonは無料ティアに含まれていないため、キーだけでは不十分です。キーの背後にあるプロジェクトで課金設定が必要です。

  1. Google AI StudioでAPIキーページを開き、キーを作成するか、既存のキーを再利用します。
  2. キーのプロジェクトが有料ティアに登録されていることを確認します。Googleのガイドには「Neonは有料ティアのみで利用可能です(無料ティアでは利用できません)」と明記されています。
  3. キーをエクスポートします:export GEMINI_API_KEY="YOUR_API_KEY"。Google GenAI SDKはこれを自動的に読み込みます。
  4. 大量のバッチ処理を計画する前に、レート制限ページで有料ティアのレート制限を確認してください。[要確認:Neonのティア別RPM・TPM数値]

最初のGemini 4 Neon APIリクエストを送信するには?

Interactionsエンドポイントにmodelとinputを送信します。これはGoogleのクイックスタート形式です:

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "model": "gemini-4-neon",
    "input": "Review this Go handler for missing error checks and suggest fixes."
  }'

Python SDKを使った同じ呼び出し(pip install -U google-genai):

from google import genai

client = genai.Client()  # reads GEMINI_API_KEY

interaction = client.interactions.create(
    model="gemini-4-neon",
    input="Review this Go handler for missing error checks and suggest fixes.",
)

print(interaction.output_text)
print(interaction.usage)

テスト中は毎回レスポンスのusageを確認しましょう。thinkingトークンは出力と同じ$15のレートで課金されるため、コストの大半はthinkingトークンの数で決まります。

これらのスニペットはGoogleのガイドに従っています。この記事のために実際に実行していないため、初回呼び出し時にレスポンス形式を必ず確認してください。

HydrogenやCarbonから切り替えると何が変わる?

すでに他のGemini 4モデルを使用している場合、切り替えにリクエストスキーマの変更は不要です。model文字列を変更し、次の3点を確認してください:

確認項目 Neon Hydrogen CarbonとArgon
デフォルトのthinkingレベル high high medium
最高レベル xhigh xhigh high
1Mあたりの入力/出力 $3/$15 $1.50/$7.50 Carbonの料金を参照

CarbonやArgonから移行する場合、デフォルトがmediumからhighに変わるため、同じプロンプトでもthinkingトークンが増えます。従来の動作にしたい場合は、thinking_levelを明示的に設定してください:

interaction = client.interactions.create(
    model="gemini-4-neon",
    input="Audit this payment retry queue for race conditions.",
    generation_config={"thinking_level": "medium"},
)

Gemini 3.8 Flash以前からの移行では、確認項目がさらに増えます。Googleの移行チェックリストに従うと:

Neonから64Kトークンを超える出力を得るには?

同期リクエストはストリーミングの有無にかかわらず65,536トークンで停止します。完全な移行仕様書とテストスイートのような長い出力が必要な場合は、backgroundをtrueに設定し、max_output_tokensを65,536より大きくしてください。Googleのサーバーは上限に達するまで、64Kトークンずつ複数回に分けて生成を続けます。

Gemini 4 Neon long decode: a background request with max_output_tokens 262,144 runs as four 65,536-token hops on Google's servers while the client polls GET /v1beta/interactions/{id} until status leaves in_progress, then joins the text from every model_output step

ジョブを開始し、そのidを保持します:

export ID=$(curl -s -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-4-neon",
    "input": "Generate a complete multi-module migration specification and test suite for this service.",
    "background": true,
    "generation_config": {
      "max_output_tokens": 262144,
      "thinking_level": "high"
    }
  }' | jq -r '.id')

その後、完了までポーリングし、各hopからのテキストを連結します(Python、エクスポートしたIDを使用):

import os, time

interaction = client.interactions.get(id=os.environ["ID"])
while interaction.status in ("in_progress", "queued"):
    time.sleep(5)
    interaction = client.interactions.get(id=interaction.id)

text = "".join(
    c.text
    for step in interaction.steps if step.type == "model_output"
    for c in step.content if c.type == "text"
)

Googleのガイドにある次の3つのルールに従えば、問題を回避できます:

  1. max_output_tokensを指定せずにbackgroundだけを設定すると、サーバーは65,536トークンで停止します。
  2. 上限は1,048,576から入力トークンを引いた値まで設定できます。長い複数ステップの作業には、Googleは131,072または262,144を推奨しています。
  3. 難しいプロンプトは数分かかることがあります。バックグラウンドモードを使用するか、HTTPクライアントのタイムアウトを最低15分に設定してください。

Google側にインタラクションを保存したくない場合は、ロングデコードガイドに、最新SDKでのクライアント側継続方法も記載されています。

NeonとHydrogenを組み合わせるには?

判断にはNeonを、大量処理にはHydrogenを使います。Neonがワークフローを計画・レビューし、そのインタラクションのidをprevious_interaction_idとしてgemini-4-hydrogenの呼び出しに渡して、単一のステップを実行させます。GoogleのCloud開発者ガイドにこのパターンが示されています:

plan = client.interactions.create(
    model="gemini-4-neon",
    input="Design a 3-step plan to migrate our REST order service to gRPC in Go.",
    store=True,
)

step = client.interactions.create(
    model="gemini-4-hydrogen",
    input="Implement step 1 (.proto service definition) from the plan.",
    previous_interaction_id=plan.id,
)
print(step.output_text)
Gemini 4 Neon as planner and Gemini 4 Hydrogen as executor: Neon writes the plan at $15 per million output tokens, then each step runs on Hydrogen at $7.50 per million through previous_interaction_id, with Neon reviewing the final result

Neonの代わりにHydrogenが書き出す出力トークンは、すべて半額で済みます。Gemini 4 Hydrogenオーケストレーターガイドでは、Carbonをプランナーにした同じループを解説しています。

Gemini 4 Neon APIのコストを抑えるには?

一般的に効果が大きい順に、4つの方法があります:

  1. 合格基準を満たす最も低いthinkingレベルを選ぶ。 Googleのアドバイスは、4つのレベルすべてで高いmax_output_tokensを使って評価を実行し、品質基準を満たす最も低いthinking_levelを選ぶことです。
  2. 長いプロンプトを再利用する。 暗黙的キャッシュは4,096トークン以上のプロンプトにデフォルトで適用され、キャッシュ済み入力のコストを95%削減し、100万トークンあたり$3.00から$0.15になります。プロンプトの長く安定した部分(システムテキスト、ドキュメント、スキーマ)を先頭に置きましょう。
  3. 実行をHydrogenに任せる。 上記の組み合わせパターンを参照してください。
  4. すべてのトークンを数える。 Googleはモデルが処理したすべてのトークンに課金します。thinkingトークンや、グラウンディング使用時に追加される内部指示も含まれます。Google検索によるグラウンディングはクエリごとにも課金されます。

簡単な目安として:入力20,000トークン、出力8,000トークン(thinkingを含む)の呼び出しは、入力に$0.06、出力に$0.12がかかり、定価で合計$0.18です。

Apidog CLIでコーディングエージェントにNeonとHydrogenを比較させる

あなたのプロンプトでは、NeonはHydrogenの2倍の価格に見合う価値があるでしょうか?コーディングエージェント(Claude Code、Codex、Cursor)に1つのテストケースを作成させ、Apidog CLIで両モデルに対して実行してみましょう。

一度だけセットアップします:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted

そしてエージェントに次のプロンプトを1つ渡します:

In Apidog project <projectId>, create an environment "gemini" with base URL
https://generativelanguage.googleapis.com and variables GEMINI_API_KEY,
MODEL (default "gemini-4-hydrogen") and THINKING (default "high"). Add an
endpoint for POST /v1beta/interactions with the x-goog-api-key header from
GEMINI_API_KEY. Create a test case that sends model {{MODEL}}, our code-review
prompt and generation_config.thinking_level {{THINKING}}, and asserts: HTTP 200,
status is "completed", a non-empty model_output step, and usage.total_tokens
exists. Run it for gemini-4-hydrogen and gemini-4-neon, then compare
usage.total_thought_tokens and usage.total_output_tokens.

エージェントは何かを書く前に、各ペイロードのスキーマを読み、JSONを検証します:

apidog environment create gemini --project <projectId> --base-url https://generativelanguage.googleapis.com
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file endpoint.json
apidog endpoint create --project <projectId> --file endpoint.json
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> --env-var "MODEL=gemini-4-hydrogen" -r cli,json
apidog run --test-case <caseId> --project <projectId> -e <envId> --env-var "MODEL=gemini-4-neon" -r cli,json

各実行のトークン数にモデルの単価を掛ければ、そのプロンプトにおけるタスクあたりの実際のコストがわかります。ローンチ記事の平均値ではありません。--upload-reportを付けるとApidogアプリで実行結果を確認でき、-r cli,jsonを-r junitに変えると同じチェックをCIに組み込めます。Apidog CLI CI/CDガイドではパイプラインを、Claude CodeでのApidog CLIではエージェントのセットアップを解説しています。ApidogのFreeプランは最大4ユーザーまで利用できます。

FAQ

Gemini 4 NeonのモデルIDは? gemini-4-neonです。Interactions APIとgenerateContentの両方で動作します。

Gemini 4 Neon APIは無料ですか? いいえ。NeonはGemini APIの有料ティア専用で、入力100万トークンあたり3ドル、出力100万トークンあたり15ドルです。Google AI ProおよびUltraの加入者はAI Studioのチャットで試用できます。

Hydrogen用のコードはNeonでも動きますか? はい。Googleによると、Gemini 4モデル間の切り替えにリクエストスキーマの変更は不要です。model文字列を更新し、デフォルトのhighthinkingレベルのままで良いか判断してください。

Gemini 4 Neon APIの最大出力は? 同期リクエスト1回あたり65,536トークンです。backgroundをtrueにしてmax_output_tokensを高く設定すれば、Neonは1,048,576トークンのウィンドウから入力分を引いた上限まで生成できます。

Gemini 4 Neonはtemperatureに対応していますか? いいえ。サーバーは範囲内のtemperature、top_p、top_kを無視し、範囲外の値には400を返します。品質と速度・コストのトレードオフにはthinking_levelを使用してください。

Neonは明示的コンテキストキャッシュに対応していますか? いいえ。リクエストからcached_contentを削除してください。暗黙的キャッシュは引き続き4,096トークン以上のプロンプトに自動適用され、キャッシュ済み入力は95%の割引になります。

ApidogでAPIデザイン中心のアプローチを取る

APIの開発と利用をよりシンプルなことにする方法を発見できる