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

# GeminiImage2Node - ComfyUI Built-in Node Documentation

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

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

GeminiImage2Node 使用 Google 的 Vertex AI Gemini 模型生成或编辑图像。它向 API 发送文本提示词以及可选的参考图像或文件，并返回生成的图像和/或文本描述。

## 输入

| 参数      | 描述                                                                                | 数据类型   | 是否必需 | 范围                                                                                                                                            |
| ------- | --------------------------------------------------------------------------------- | ------ | ---- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `提示词`   | 描述要生成的图像或要应用的编辑的文本提示词。包含模型应遵循的任何约束、样式或细节。                                         | STRING | 是    | 不适用                                                                                                                                           |
| `模型`    | 用于生成图像的特定 Gemini 模型。"Nano Banana 2" 选项在内部映射到 `gemini-3.1-flash-image-preview` 模型。 | COMBO  | 是    | `"gemini-3-pro-image-preview"`<br />`"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"`                                                                                                                |
| `响应模态`  | 选择 'IMAGE' 仅输出图像，或选择 'IMAGE+TEXT' 同时返回生成的图像和文本响应。                                 | COMBO  | 是    | `"IMAGE+TEXT"`<br />`"IMAGE"`                                                                                                                 |
| `图像`    | 可选的参考图像。要包含多张图像，请使用批量图像节点（最多 14 张）。                                               | IMAGE  | 否    | 不适用                                                                                                                                           |
| `文件`    | 可选的文件，用作模型的上下文。接受来自 Gemini 生成内容输入文件节点的输入。                                         | CUSTOM | 否    | 不适用                                                                                                                                           |
| `系统提示词` | 规定 AI 行为的基础指令。默认值：用于图像生成的预定义系统提示词。                                                | STRING | 否    | 不适用                                                                                                                                           |

**约束条件：**

* `images` 输入最多支持 14 张图像。如果提供更多，将引发错误。
* `files` 输入必须连接到输出 `GEMINI_INPUT_FILES` 数据类型的节点。

## 输出

| 输出名称     | 描述                                      | 数据类型   |
| -------- | --------------------------------------- | ------ |
| `image`  | 由 Gemini 模型生成或编辑的图像。                    | IMAGE  |
| `string` | 来自模型的文本响应。如果 `响应模态` 设置为 "IMAGE"，此输出将为空。 | STRING |

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

***

**Source fingerprint (SHA-256):** `20a937a635f883a42e22582ae415f6d2a9a6ecc50f147c9090431877e5461144`