Text
Gemini 4 Neon
ネイティブ Gemini リクエスト、4 段階の思考、継続トークンを使う長文の分割生成、ツール、マルチモーダル入力、ストリーミング。モデルの制限と検証状況も含まれます。
ネイティブ Gemini 形式で gemini-4-neon を使います。モデルページには Playground と現在の料金があります。Gemini 4 Neon は Gemini 4 Hydrogen と Gemini 4 Carbon の中間に位置づけられ、同じネイティブの generateContent リクエスト形式を使います。Google の移行ガイドでは、Gemini 4 モデル間の移行にリクエストスキーマの変更は不要とされています。
モデル ID
| モデル ID | コンテキストウィンドウ | デフォルトの思考レベル |
|---|---|---|
gemini-4-neon | 入力、思考、出力で共有する 1,048,576 トークン | high |
Default 枠には gemini-4-neon を使うか、モデル検出で返される明示的な gemini-4-neon:GROUP_NAME 枠を選択してください。リクエストを送信する前に、利用可能な枠を確認してください。
簡単な例
curl https://api.seedrouter.ai/v1beta/models/gemini-4-neon:generateContent \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"role":"user","parts":[{"text":"Audit this payment retry queue for race conditions and propose lock acquisition steps."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"high"},"maxOutputTokens":65536}}'モデルは URL に指定します。contents は必須です。回答にはネイティブの candidates、finishReason、usageMetadata が含まれます。会話履歴には thoughtSignature を含むコンテンツの全パートを保持してください。難しいプロンプトでは数分かかる場合があります。Google はクライアントのタイムアウトを 20 分にすることを推奨しています。出力を準備でき次第受け取るにはストリーミングを使ってください。
エンドポイント
| 操作 | エンドポイント |
|---|---|
| JSON 応答 | POST /v1beta/models/gemini-4-neon:generateContent |
| サーバー送信イベント | POST /v1beta/models/gemini-4-neon:streamGenerateContent?alt=sse |
OpenAPI 仕様には、ネストされたすべてのリクエストと応答のスキーマが含まれます。省略した任意フィールドには API のデフォルトが適用されます。公開ネイティブ API は送信された本文を保持し、Gemini が検証します。Playground は送信前に文書化された制約も確認し、安全設定を適用します。
リクエストパラメータ
URL によりモデルは gemini-4-neon に固定されます。リクエスト契約には 11 個のトップレベルフィールドがあります。必須と記されていないフィールドは任意です。省略と JSON null は異なります。公式スキーマで許可されている箇所では、null を許容する任意の JSON が保持されます。
| フィールド | 型 | 必須 | デフォルトと制約 |
|---|---|---|---|
contents | object[] | はい | 空でない会話。各 content の parts も空にできません |
systemInstruction | object | いいえ | テキストのパートのみ。ユーザーの識別情報は自動挿入されません |
generationConfig | object | いいえ | 次の表の生成パラメータ |
tools | object[] | いいえ | 関数宣言と組み込みツールの設定 |
toolConfig | object | いいえ | 関数選択と検索の設定 |
safetySettings | object[] | いいえ | カテゴリごとに 1 つの設定。カテゴリの重複は不可 |
serviceTier | string | いいえ | unspecified、standard、flex、priority。通常の処理は standard |
continuationToken | string | いいえ | finishReason: CONTINUATION または MAX_TOKENS とともに返されるトークン。同じリクエストに付けて再送すると長い回答を続けられます |
labels | object | いいえ | 文字列値。キーと値は小文字で、それぞれ最大 63 Unicode コードポイント |
model | string | いいえ | 任意のリソース名。実際のモデルは URL が決定します |
store | boolean | いいえ | 汎用のリクエスト保存設定。このモデル固有の効果は未検証 |
Gemini 4 Neon は明示的なコンテキストキャッシュ(cachedContent と cachedContents リソース)に対応していません。4,096 トークン以上のプロンプトでは暗黙的なキャッシュがデフォルトで有効です。
生成パラメータ
generationConfig 内のフィールド | 型 | デフォルトと制約 |
|---|---|---|
maxOutputTokens | integer | デフォルトは思考を含めて 65,536。継続により最大 1,048,576 から入力分を引いた量まで。各ストリーミング応答と非ストリーミング応答は最大 65,536 トークン。より長い出力には継続を使用 |
thinkingConfig | object | thinkingLevel:low、medium、high、xhigh(デフォルト high)。大文字表記も可。includeThoughts:boolean、デフォルト false。thinkingLevel を使用してください。非推奨の thinkingBudget は単独で指定すると警告付きでレベルにマッピングされ、thinkingLevel との併用は不可 |
stopSequences | string[] | 最大 5 個のシーケンス |
responseMimeType | string | デフォルト text/plain。従来の JSON スキーマ出力には application/json が必要 |
responseSchema | object | 公式スキーマ方言。responseJsonSchema とは排他的 |
responseJsonSchema | JSON | JSON Schema。responseSchema とは排他的 |
responseFormat | object | テキスト形式の設定。text.mimeType と任意の text.schema。スキーマには JSON MIME タイプが必要 |
responseModalities | string[] | テキストのみ:TEXT。空ならテキスト |
mediaResolution | enum | MEDIA_RESOLUTION_UNSPECIFIED、および MEDIA_RESOLUTION_ 接頭辞付きの LOW、MEDIUM、HIGH |
seed | integer | 符号付き 32 ビット値。このモデル固有の決定的動作は未検証 |
presencePenalty | number | 汎用フィールド。このモデル固有の効果と範囲は未検証 |
frequencyPenalty | number | 汎用フィールド。このモデル固有の効果と範囲は未検証 |
responseLogprobs | boolean | 汎用フィールド。このモデルでの利用可否は未検証 |
logprobs | integer | 0–20。responseLogprobs: true が必要。モデルの対応は未検証 |
enableEnhancedCivicAnswers | boolean | 汎用フィールド。モデルの対応は未検証 |
enableAffectiveDialog | boolean | 汎用フィールド。モデルの対応は未検証 |
audioTranscriptionConfig | object | 汎用フィールド。このモデル固有の選択肢は未検証 |
translationConfig | object | 汎用フィールド。このモデル固有の選択肢は未検証 |
OpenAPI ドキュメントには、v1beta ディスカバリ仕様の audioMetadata、documentMetadata、spreadsheetMetadata、videoMetadata.contentLayers を含む、各メッセージのネスト型、列挙値、必須プロパティ、文書化された境界値が記載されています。スキーマは公式パラメータを記述するもので、SeedRouter のリクエスト許可リストではありません。呼び出し側が指定したフィールドと値は保持されます。スキーマがフィールドを受け付けることは、すべてのアカウントでの対応を証明しません。minimal は記載された思考レベルに含まれません。Google は temperature、topP、topK、candidateCount は非推奨で削除すべきとしており、範囲内のカスタムサンプリング値は無視され、範囲外の値は 400 を返します。ネイティブ JSON で送信した場合も、Gemini API が処理するよう変更せずに渡されます。
長文の分割生成
Gemini 4 Neon の 1 回の応答は、ストリーミングで最大 65,536 トークン、非ストリーミングでも最大 65,536 トークンです。さらに出力するには maxOutputTokens を 65,536 より大きくし、自分で回答を継続します。
- リクエストを送信します。応答が
finishReason: "CONTINUATION"で終わる場合、candidates[0].continuationTokenを読み取ります。 - トップレベルの
continuationTokenにその値を入れ、同じリクエストを再送します。部分出力をcontentsに追加しないでください。トークンには思考を含むモデルの状態が含まれます。 finishReasonがSTOPまたはMAX_TOKENSになるまで繰り返します。呼び出しがMAX_TOKENSに達してcontinuationTokenを返した場合、再開できるのはmaxOutputTokensを増やしたときのみです。同じ上限のまま再送すると400 INVALID_ARGUMENTが返ります。
{
"contents": [{"role": "user", "parts": [{"text": "Generate a complete multi-module migration specification and verification checklist for this payment service."}]}],
"generationConfig": {"thinkingConfig": {"thinkingLevel": "high"}, "maxOutputTokens": 262144},
"continuationToken": "TOKEN_FROM_THE_PREVIOUS_RESPONSE"
}1 回の応答がすべて思考に使われると、空のテキストと CONTINUATION が返る場合があります。これは正常な進行です。毎回、プロンプトとそれまでの全生成内容がモデルに再送されるため、後続の各回で入力トークンが再計上されます(重複するプレフィックスは暗黙的キャッシュの対象になります)。SeedRouter は各回を独立したリクエストとして課金します。Interactions API のサーバー側 background モードはこのエンドポイントには含まれません。
構造化出力
{
"contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
"generationConfig": {
"thinkingConfig": {"thinkingLevel": "low"},
"maxOutputTokens": 65536,
"responseMimeType": "application/json",
"responseJsonSchema": {
"type": "object",
"properties": {"ok": {"type": "boolean"}},
"required": ["ok"]
}
}
}従来の responseSchema と responseJsonSchema は併用できません。どちらも responseMimeType: "application/json" が必要です。新しい responseFormat.text スキーマも JSON を指定する必要があります。そのメッセージでは REST 列挙値の表記(APPLICATION_JSON と TEXT_PLAIN)を使ってください。リクエストは変更せずに渡され、メディアの MIME タイプや任意の関数 JSON は書き換えられません。
関数と組み込みツール
tools[].functionDeclarations で名前と、parameters または parametersJsonSchema のどちらか一方を指定します。両方は指定できません。関数選択は toolConfig.functionCallingConfig で行い、allowedFunctionNames には ANY または VALIDATED と宣言済みの名前が必要です。宣言されたツールを使わずに生テキストの JSON ツール呼び出しを出力するようシステム指示でモデルに求めないでください。MALFORMED_FUNCTION_CALL が返る場合があります。
アプリケーションが返された関数を実行し、次の会話ターンで結果を渡します。元の thoughtSignature、関数呼び出し、関数応答をそれぞれ保持してください。並列の functionCall パート間で思考シグネチャをコピーしないでください。また、不透明な関数引数をシリアライズする際、数値識別子を丸めないでください。
Google は Gemini 4 Neon 向けに Search、Maps、コード実行、URL コンテキスト、File Search、Computer Use を挙げています。File Search リソースには、リクエストを処理する認証情報でアクセスできる必要があります。汎用スキーマにはネイティブ MCP 設定がありますが、このモデルでの利用可否は確立されていません。メディアと組み合わせる前に各ツールの公式制限を確認してください。グラウンディングでは、Google は内部ツール指示と関数宣言を入力トークンとして計上します。Playground はカスタム関数を実行しません。
マルチモーダル入力と安全性
contents[].parts[] の項目には、テキスト、インラインメディア、ファイル参照、関数呼び出し/応答、実行パートのうち厳密に 1 つのペイロードを指定します。シグネチャやメディアメタデータ(videoMetadata、audioMetadata、documentMetadata、spreadsheetMetadata、mediaResolution、mediaProcessing)を含めることもできます。入力はテキスト、画像、音声、動画、PDF に対応し、出力はテキストのみです。画像や音声の生成、Live API はありません。
インラインバイトには inlineData.mimeType と base64 の data を使います。ファイル参照には fileData.mimeType と fileUri を使います。構文上有効な URL でも、モデルが取得できる証明にはなりません。動画メタデータには startOffset、endOffset、24 以下の正の fps、contentLayers を指定できます。動画の fileData または inlineData の横に mediaProcessing: "AGENTIC" を指定し、パートごとにエージェント型の動画理解を選びます。デフォルトは静的処理です。
安全設定は公式ネイティブ形式を使い、API を通じて変更せずに渡されます。Playground では 4 カテゴリすべてを BLOCK_MEDIUM_AND_ABOVE 以上の厳しさに設定する必要があります。より低いしきい値は API 経由でのみ利用できます。
JSON 応答とストリーミング
generateContent はネイティブ JSON を返します。streamGenerateContent?alt=sse は SSE の data: イベントでネイティブ JSON を出力します。主なフィールドは candidates[].content.parts、finishReason、continuationToken、safetyRatings、groundingMetadata、promptFeedback、modelVersion、responseId、usageMetadata です。
会話履歴には完全なネイティブコンテンツを保持してください。思考の要約と思考シグネチャは異なります。切断だけでは生成の失敗や完了を判断できません。別のリクエストを送る前に、部分結果とアカウント記録を確認してください。ストリームの使用量は累積値なので、各チャンクを合計せずに最新のカウンタを使います。
使用量と料金
promptTokenCount はキャッシュ入力を含みます。cachedContentTokenCount はキャッシュ入力料金で課金され、非キャッシュ入力として重複課金されません。課金対象の出力は candidatesTokenCount と thoughtsTokenCount の合計です。Gemini 4 Neon のデフォルトの思考は high です。他モデルとの使用量比較ではレベルを明示してください。
このモデルにコンテキスト長による段階料金はありません。現在の SeedRouter 料金は Standard のトークン料金です。この統合では Flex 割引と Priority 割増は設定されていません。これらの処理枠の対応は引き続き検証が必要です。Google Search グラウンディングではトークン使用量に加えてクエリごとの料金が発生する場合があります。有効化前にツール料金を確認してください。失敗したリクエストには課金されません。現在の料金表をご覧ください。
アカウントのグループ
Default 枠は接尾辞のない gemini-4-neon モデル ID を使います。追加の枠は URL で gemini-4-neon:GROUP_NAME を使います。Playground は利用可能な枠を選びます。API では次のヘッダーでも明示できます。
X-SeedRouter-Group: GROUP_NAME選択したグループが料金と利用可能な容量を決定します。明示的な選択後に別のグループへ黙って切り替わることはありません。ヘッダーを省略するか auto を指定すると、API キーのデフォルト動作を維持します。
回答を生成せず、API キーで利用可能なグループを確認できます。
curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-neon" \
-H "Authorization: Bearer YOUR_SEEDROUTER_KEY"検証状況
公式ドキュメントと REST ディスカバリ リビジョン 20261119 は 2026 年 11 月 20 日に確認しました。同日、読み取り専用のモデル検出(GET /v1/models)、グループ検出(GET /api/seedrouter/llm/groups?model=gemini-4-neon)、公開料金(GET /v1/pricing)により、Default の gemini-4-neon 枠と明示的な gemini-4-neon:googlellm-vertext 枠の両方を確認しました。また、api.seedrouter.ai を通じた各 1 回の有料スモーク呼び出し 3 件が HTTP 200 で完了しました。Default での low 思考による JSON 生成(プロンプト 54、出力 28、思考 39 トークン)、Default での xhigh 思考による SSE ストリーミング(プロンプト 50、出力 13、思考 207 トークン)、gemini-4-neon:googlellm-vertext での low 思考による宣言済み functionCall(プロンプト 95、出力 22、思考 49 トークン、thoughtSignature を返却)です。ネイティブ本文のパススルーと応答フィールド許可リストの適用には、更新済みバックエンドビルドのデプロイが必要です。メディア理解、グラウンディング、Computer Use、継続/長文の分割生成、その他の汎用フィールド、処理枠は未検証であり、これらの確認は比較上の品質やレイテンシを示すものではありません。
