Nano Banana Pro（Google Gemini 图像） - ComfyUI Built-in Node Documentation

通过 Google Vertex AI Gemini API 同步生成或编辑图像。

通过 Google Vertex AI Gemini API 同步生成或编辑图像。您提供文本提示，并可以选择附加参考图像或 Gemini 输入文件。该节点会返回生成的图像，并根据所选的响应模式返回文本响应。

输入

参数	描述	数据类型	必需	范围
`提示词`	文本提示，描述要生成或要应用的编辑。包括模型应遵循的任何约束、风格或细节。去除空白字符后，提示必须至少包含一个字符。	STRING	是	N/A
`模型`	用于生成的 Gemini 模型。"Nano Banana 2 (Gemini 3.1 Flash Image)" 选项会以 `gemini-3.1-flash-image` 发送；"gemini-3-pro-image-preview" 会以 `gemini-3-pro-image` 发送。	COMBO	是	"gemini-3-pro-image-preview" "Nano Banana 2 (Gemini 3.1 Flash 图像)"
`随机种`	当 `seed` 固定为特定值时，模型会尽力为重复请求提供相同的响应。不保证输出具有确定性。此外，即使使用相同的 `seed` 值，更改模型或参数设置（例如 temperature）也可能导致响应发生变化。默认情况下，使用随机 `seed` 值。默认值：42。	INT	是	0 到 18446744073709551615
`宽高比`	如果设置为 'auto'，则匹配输入图像的宽高比；如果未提供图像，通常生成 16:9 的图像。默认值："auto"。	COMBO	是	"auto" "1:1" "2:3" "3:2" "3:4" "4:3" "4:5" "5:4" "9:16" "16:9" "21:9"
`分辨率`	目标输出分辨率。对于 2K/4K，使用原生 Gemini 放大器。	COMBO	是	"1K" "2K" "4K"
`响应模态`	选择 'IMAGE' 仅输出图像，或选择 'IMAGE+TEXT' 同时返回生成的图像和文本响应。高级设置。	COMBO	是	"IMAGE+TEXT" "IMAGE"
`图像`	可选的参考图像。要包含多张图像，请使用 Batch Images 节点（最多 14 张）。	IMAGE	否	N/A
`文件`	可选的文件，用作模型的上下文。接受来自 Gemini Generate Content Input Files 节点的输入。	GEMINI\_INPUT\_FILES	否	N/A
`系统提示词`	决定 AI 行为的基础指令。默认值：用于图像生成的预定义系统提示。高级设置。	STRING	否	N/A

约束：

images 输入最多支持 14 张图像。如果提供的图像超过此数量，将引发错误。
当提供的图像超过 10 张时，前 10 张会作为 URL 引用上传，其余图像会在请求中内联发送。
files 输入必须连接到输出 GEMINI_INPUT_FILES 数据类型的节点。
当 response_modalities 设置为 "IMAGE" 时，仅返回图像，文本输出为空。
prompt 输入会经过验证，去除空白字符后必须至少包含一个字符。

输出

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

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！在 GitHub 上编辑

Source fingerprint (SHA-256): 02293dad786d4b441da3174fa76f6c5847f122d294bd7e1f765ffd72420034a4