> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# GeminiNodeV3 - ComfyUI Built-in Node Documentation

> Google の Gemini モデルでテキスト応答を生成します。

Google の Gemini モデルでテキスト応答を生成します。テキストプロンプトを指定し、必要に応じて1つ以上の画像、音声クリップ、動画、またはファイルをマルチモーダルコンテキストとして指定できます。選択したモデルによって、表示される追加設定が決まります。

## 入力

### 共通入力

| パラメータ   | 説明                                                 | データ型           | 必須 | 範囲                                                                                                                              |
| ------- | -------------------------------------------------- | -------------- | -- | ------------------------------------------------------------------------------------------------------------------------------- |
| `model` | 応答の生成に使用する Gemini モデル。選択したモデルによって、表示される追加入力が決まります。 | DYNAMIC\_COMBO | はい | `"Gemini 3.8 Flash"`<br />`"Gemini 3.7 Flash"`<br />`"Gemini 3.5 Flash"`<br />`"Gemini 3.1 Pro"`<br />`"Gemini 3.1 Flash-Lite"` |

### メディア入力

これらの拡張可能なメディア入力は、すべてのモデルオプションで使用できます。

| パラメータ    | 説明                                                                        | データ型  | 必須  | 範囲       |
| -------- | ------------------------------------------------------------------------- | ----- | --- | -------- |
| `images` | モデルのコンテキストとして使用する任意の画像。最大16枚。拡張可能スロット: `image_1` から `image_16` に画像を接続します。 | IMAGE | いいえ | 最大16枚の画像 |
| `audio`  | モデルのコンテキストとして使用する任意の音声クリップ。拡張可能スロット: `audio_1`。                           | AUDIO | いいえ | 音声クリップ1件 |
| `video`  | モデルのコンテキストとして使用する任意の動画クリップ。拡張可能スロット: `video_1`。                           | VIDEO | いいえ | 動画クリップ1件 |

### Gemini 3.8 Flash 入力

| パラメータ               | 説明                                                                                                                                                          | データ型                 | 必須  | 範囲                                                       |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | --- | -------------------------------------------------------- |
| `prompt`            | モデルへのテキスト入力。詳細な指示、質問、またはコンテキストを含めます。空にできません。                                                                                                                | STRING               | はい  | 複数行テキスト（少なくとも1つの空白以外の文字を含む必要があります）                       |
| `video_processing`  | モデルが添付動画を読み取る方法。`static` は固定レートでフレームをサンプリングし、それらをすべてコンテキストとして送信します。`agentic` はモデル自身がタイムラインを移動し、必要なフレーム、音声、または文字起こしのみを読み込むため、長い動画で入力トークンを大幅に削減できます。          | COMBO                | はい  | `"static"`<br />`"agentic"`（デフォルト: `"static"`）           |
| `files`             | モデルのコンテキストとして使用する任意のファイル。Gemini Input Files ノードからの入力を受け付けます。                                                                                                | GEMINI\_INPUT\_FILES | いいえ | N/A                                                      |
| `thinking_level`    | モデルが回答前に内部的にどれだけ深く推論するか。HIGH は難しいタスクの品質を向上させますが、より多くの（思考）トークンを消費し、遅くなります。                                                                                   | COMBO                | はい  | `"LOW"`<br />`"MEDIUM"`<br />`"HIGH"`（デフォルト: `"MEDIUM"`） |
| `max_output_tokens` | 生成する最大トークン数（モデルの内部思考を含む）。thinking\_level が HIGH の場合、低い値では回答の余地がなくなることがあります。応答が空または切り詰められて返ってくる場合は、この値を増やしてください。モデルは終了時に早く停止するため、短い応答では上限を高くしても追加コストはかかりません。 | INT                  | はい  | 16-65536（デフォルト: 32768）                                   |
| `seed`              | サンプリング用のシード。ランダムシードにするには0に設定します。決定的な出力は保証されません。                                                                                                             | INT                  | はい  | 0-2147483647（デフォルト: 42）                                  |
| `system_prompt`     | モデルの動作を規定する基本的な指示。                                                                                                                                          | STRING               | はい  | 複数行テキスト（デフォルト: 空）                                        |

### Gemini 3.7 Flash 入力

| パラメータ               | 説明                                                                                                                                                          | データ型                 | 必須  | 範囲                                                       |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | --- | -------------------------------------------------------- |
| `prompt`            | モデルへのテキスト入力。詳細な指示、質問、またはコンテキストを含めます。空にできません。                                                                                                                | STRING               | はい  | 複数行テキスト（少なくとも1つの空白以外の文字を含む必要があります）                       |
| `files`             | モデルのコンテキストとして使用する任意のファイル。Gemini Input Files ノードからの入力を受け付けます。                                                                                                | GEMINI\_INPUT\_FILES | いいえ | N/A                                                      |
| `thinking_level`    | モデルが回答前に内部的にどれだけ深く推論するか。HIGH は難しいタスクの品質を向上させますが、より多くの（思考）トークンを消費し、遅くなります。                                                                                   | COMBO                | はい  | `"LOW"`<br />`"MEDIUM"`<br />`"HIGH"`（デフォルト: `"MEDIUM"`） |
| `temperature`       | ランダム性を制御します。低いほど集中的/決定的になり、高いほど創造的になります。                                                                                                                    | FLOAT                | はい  | 0.0-2.0（デフォルト: 1.0）                                      |
| `top_p`             | Nucleus sampling: 累積確率が top\_p に達する最小のトークン集合からサンプリングします。                                                                                                    | FLOAT                | はい  | 0.0-1.0（デフォルト: 0.95）                                     |
| `max_output_tokens` | 生成する最大トークン数（モデルの内部思考を含む）。thinking\_level が HIGH の場合、低い値では回答の余地がなくなることがあります。応答が空または切り詰められて返ってくる場合は、この値を増やしてください。モデルは終了時に早く停止するため、短い応答では上限を高くしても追加コストはかかりません。 | INT                  | はい  | 16-65536（デフォルト: 32768）                                   |
| `seed`              | サンプリング用のシード。ランダムシードにするには0に設定します。決定的な出力は保証されません。                                                                                                             | INT                  | はい  | 0-2147483647（デフォルト: 42）                                  |
| `system_prompt`     | モデルの動作を規定する基本的な指示。                                                                                                                                          | STRING               | はい  | 複数行テキスト（デフォルト: 空）                                        |

### Gemini 3.5 Flash 入力

| パラメータ               | 説明                                                                                                                                                          | データ型                 | 必須  | 範囲                                                                        |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | --- | ------------------------------------------------------------------------- |
| `prompt`            | モデルへのテキスト入力。詳細な指示、質問、またはコンテキストを含めます。空にできません。                                                                                                                | STRING               | はい  | 複数行テキスト（少なくとも1つの空白以外の文字を含む必要があります）                                        |
| `files`             | モデルのコンテキストとして使用する任意のファイル。Gemini Input Files ノードからの入力を受け付けます。                                                                                                | GEMINI\_INPUT\_FILES | いいえ | N/A                                                                       |
| `thinking_level`    | モデルが回答前に内部的にどれだけ深く推論するか。HIGH は難しいタスクの品質を向上させますが、より多くの（思考）トークンを消費し、遅くなります。                                                                                   | COMBO                | はい  | `"MINIMAL"`<br />`"LOW"`<br />`"MEDIUM"`<br />`"HIGH"`（デフォルト: `"MEDIUM"`） |
| `temperature`       | ランダム性を制御します。低いほど集中的/決定的になり、高いほど創造的になります。                                                                                                                    | FLOAT                | はい  | 0.0-2.0（デフォルト: 1.0）                                                       |
| `top_p`             | Nucleus sampling: 累積確率が top\_p に達する最小のトークン集合からサンプリングします。                                                                                                    | FLOAT                | はい  | 0.0-1.0（デフォルト: 0.95）                                                      |
| `max_output_tokens` | 生成する最大トークン数（モデルの内部思考を含む）。thinking\_level が HIGH の場合、低い値では回答の余地がなくなることがあります。応答が空または切り詰められて返ってくる場合は、この値を増やしてください。モデルは終了時に早く停止するため、短い応答では上限を高くしても追加コストはかかりません。 | INT                  | はい  | 16-65536（デフォルト: 32768）                                                    |
| `seed`              | サンプリング用のシード。ランダムシードにするには0に設定します。決定的な出力は保証されません。                                                                                                             | INT                  | はい  | 0-2147483647（デフォルト: 42）                                                   |
| `system_prompt`     | モデルの動作を規定する基本的な指示。                                                                                                                                          | STRING               | はい  | 複数行テキスト（デフォルト: 空）                                                         |

### Gemini 3.1 Pro 入力

| パラメータ               | 説明                                                                                                                                                          | データ型                 | 必須  | 範囲                                     |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | --- | -------------------------------------- |
| `prompt`            | モデルへのテキスト入力。詳細な指示、質問、またはコンテキストを含めます。空にできません。                                                                                                                | STRING               | はい  | 複数行テキスト（少なくとも1つの空白以外の文字を含む必要があります）     |
| `files`             | モデルのコンテキストとして使用する任意のファイル。Gemini Input Files ノードからの入力を受け付けます。                                                                                                | GEMINI\_INPUT\_FILES | いいえ | N/A                                    |
| `thinking_level`    | モデルが回答前に内部的にどれだけ深く推論するか。HIGH は難しいタスクの品質を向上させますが、より多くの（思考）トークンを消費し、遅くなります。                                                                                   | COMBO                | はい  | `"LOW"`<br />`"HIGH"`（デフォルト: `"HIGH"`） |
| `temperature`       | ランダム性を制御します。低いほど集中的/決定的になり、高いほど創造的になります。                                                                                                                    | FLOAT                | はい  | 0.0-2.0（デフォルト: 1.0）                    |
| `top_p`             | Nucleus sampling: 累積確率が top\_p に達する最小のトークン集合からサンプリングします。                                                                                                    | FLOAT                | はい  | 0.0-1.0（デフォルト: 0.95）                   |
| `max_output_tokens` | 生成する最大トークン数（モデルの内部思考を含む）。thinking\_level が HIGH の場合、低い値では回答の余地がなくなることがあります。応答が空または切り詰められて返ってくる場合は、この値を増やしてください。モデルは終了時に早く停止するため、短い応答では上限を高くしても追加コストはかかりません。 | INT                  | はい  | 16-65536（デフォルト: 32768）                 |
| `seed`              | サンプリング用のシード。ランダムシードにするには0に設定します。決定的な出力は保証されません。                                                                                                             | INT                  | はい  | 0-2147483647（デフォルト: 42）                |
| `system_prompt`     | モデルの動作を規定する基本的な指示。                                                                                                                                          | STRING               | はい  | 複数行テキスト（デフォルト: 空）                      |

### Gemini 3.1 Flash-Lite 入力

| パラメータ               | 説明                                                                                                                                                          | データ型                 | 必須  | 範囲                                    |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | --- | ------------------------------------- |
| `prompt`            | モデルへのテキスト入力。詳細な指示、質問、またはコンテキストを含めます。空にできません。                                                                                                                | STRING               | はい  | 複数行テキスト（少なくとも1つの空白以外の文字を含む必要があります）    |
| `files`             | モデルのコンテキストとして使用する任意のファイル。Gemini Input Files ノードからの入力を受け付けます。                                                                                                | GEMINI\_INPUT\_FILES | いいえ | N/A                                   |
| `thinking_level`    | モデルが回答前に内部的にどれだけ深く推論するか。HIGH は難しいタスクの品質を向上させますが、より多くの（思考）トークンを消費し、遅くなります。                                                                                   | COMBO                | はい  | `"LOW"`<br />`"HIGH"`（デフォルト: `"LOW"`） |
| `temperature`       | ランダム性を制御します。低いほど集中的/決定的になり、高いほど創造的になります。                                                                                                                    | FLOAT                | はい  | 0.0-2.0（デフォルト: 1.0）                   |
| `top_p`             | Nucleus sampling: 累積確率が top\_p に達する最小のトークン集合からサンプリングします。                                                                                                    | FLOAT                | はい  | 0.0-1.0（デフォルト: 0.95）                  |
| `max_output_tokens` | 生成する最大トークン数（モデルの内部思考を含む）。thinking\_level が HIGH の場合、低い値では回答の余地がなくなることがあります。応答が空または切り詰められて返ってくる場合は、この値を増やしてください。モデルは終了時に早く停止するため、短い応答では上限を高くしても追加コストはかかりません。 | INT                  | はい  | 16-65536（デフォルト: 32768）                |
| `seed`              | サンプリング用のシード。ランダムシードにするには0に設定します。決定的な出力は保証されません。                                                                                                             | INT                  | はい  | 0-2147483647（デフォルト: 42）               |
| `system_prompt`     | モデルの動作を規定する基本的な指示。                                                                                                                                          | STRING               | はい  | 複数行テキスト（デフォルト: 空）                     |

注: Gemini 3.8 Flash では `temperature` と `top_p` は利用できず、`video_processing` はこのモデルオプションでのみ利用できます。`thinking_level` のオプションとデフォルトは、上記のとおりモデルによって異なります。

注: `prompt` 入力は空にできません。ノードは、少なくとも1つの空白以外の文字が含まれていることを検証します。

注: ノードは、最初の最大10個のメディア項目を URL としてアップロードし、動画、音声、画像の順に優先します。残りのメディアは base64 としてインラインで送信されます。インラインメディアの合計は18 MBに制限されています。超えた場合、ノードは添付メディアの数またはサイズを減らすよう求めるエラーを発生させます。

## 出力

| 出力名      | 説明                              | データ型   |
| -------- | ------------------------------- | ------ |
| `STRING` | 選択した Gemini モデルによって生成されたテキスト応答。 | STRING |

> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GeminiNodeV3/ja.md)

***

**Source fingerprint (SHA-256):** `d04d1e97a9c213297899291ad30db14a9f946b07506d0377fead4e29510c5ad9`