> ## 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.

# GeminiNanoBanana2 - ComfyUI Built-in Node Documentation

> Complete documentation for the GeminiNanoBanana2 node in ComfyUI. Learn its inputs, outputs, parameters and usage.

GeminiNanoBanana2 节点使用 Google 的 Vertex AI Gemini 模型生成或编辑图像。其工作原理是将文本提示以及可选的参考图像或文件发送至 API，并返回生成的图像及任何附带的文本。

## 输入

| 参数      | 描述                                                                                                           | 数据类型   | 是否必填 | 取值范围                                                                                                                                          |
| ------- | ------------------------------------------------------------------------------------------------------------ | ------ | ---- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `提示词`   | 描述要生成的图像或要应用的编辑的文本提示。请包含模型应遵循的任何约束、风格或细节。                                                                    | STRING | 是    | 无                                                                                                                                             |
| `模型`    | 用于图像生成的特定 Gemini 模型。                                                                                         | COMBO  | 是    | `"Nano Banana 2 (Gemini 3.1 Flash Image)"`                                                                                                    |
| `种子`    | 当种子固定为特定值时，模型会尽力为重复请求提供相同的响应。但不保证输出具有确定性。此外，更改模型或参数设置（例如温度）可能会导致响应发生变化，即使使用相同的种子值也是如此。默认情况下，使用随机种子值。（默认值：42） | INT    | 是    | 0 到 18446744073709551615                                                                                                                      |
| `宽高比`   | 如果设置为 'auto'，则匹配输入图像的宽高比；如果未提供图像，通常生成 16:9 的方形图像。（默认值："auto"）                                                | COMBO  | 是    | `"auto"`<br />`"1:1"`<br />`"2:3"`<br />`"3:2"`<br />`"3:4"`<br />`"4:3"`<br />`"4:5"`<br />`"5:4"`<br />`"9:16"`<br />`"16:9"`<br />`"21:9"` |
| `分辨率`   | 目标输出分辨率。对于 2K/4K，使用原生 Gemini 升频器。                                                                            | COMBO  | 是    | `"1K"`<br />`"2K"`<br />`"4K"`                                                                                                                |
| `响应模式`  | 决定模型返回的内容类型。（高级）                                                                                             | COMBO  | 是    | `"IMAGE"`<br />`"IMAGE+TEXT"`                                                                                                                 |
| `思考层级`  | 控制模型推理过程的深度。                                                                                                 | COMBO  | 是    | `"MINIMAL"`<br />`"HIGH"`                                                                                                                     |
| `图像`    | 可选的参考图像。如需包含多张图像，请使用批量图像节点（最多 14 张）。                                                                         | IMAGE  | 否    | 无                                                                                                                                             |
| `文件`    | 可选的文件，用作模型的上下文。接受来自 Gemini 生成内容输入文件节点的输入。                                                                    | CUSTOM | 否    | 无                                                                                                                                             |
| `系统提示词` | 规定 AI 行为的基础指令。（高级）                                                                                           | STRING | 否    | 无                                                                                                                                             |

**注意：** `images` 输入最多支持 14 张图像。如果提供更多，节点将引发错误。

## 输出

| 输出名称            | 描述                                                        | 数据类型   |
| --------------- | --------------------------------------------------------- | ------ |
| `image`         | 模型生成或编辑的主要图像。                                             | IMAGE  |
| `thought_image` | 模型返回的任何文本内容。                                              | STRING |
| `thought_image` | 模型思考过程中的第一张图像。仅在 `思考层级` 为 HIGH 且 `响应模式` 为 IMAGE+TEXT 时可用。 | IMAGE  |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GeminiNanoBanana2/zh.md)

***

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