GeminiImage2Node - ComfyUI Built-in Node Documentation

The GeminiImage2Node generates or edits images using Google’s Vertex AI Gemini model. It sends a text prompt and optional reference images or files to the API and returns the generated image and/or a text description.

Inputs

Parameter	Description	Data Type	Required	Range
`prompt`	Text prompt describing the image to generate or the edits to apply. Include any constraints, styles, or details the model should follow.	STRING	Yes	N/A
`model`	The specific Gemini model to use for generation. The “Nano Banana 2” option maps to the `gemini-3.1-flash-image-preview` model internally.	COMBO	Yes	`"gemini-3-pro-image-preview"` `"Nano Banana 2 (Gemini 3.1 Flash Image)"`
`seed`	When fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn’t guaranteed. Changing the model or other settings can cause variations even with the same seed. Default: 42.	INT	Yes	0 to 18446744073709551615
`aspect_ratio`	The desired aspect ratio for the output image. If set to ‘auto’, it matches your input image’s aspect ratio; if no image is provided, a 16:9 square is usually generated. Default: “auto”.	COMBO	Yes	`"auto"` `"1:1"` `"2:3"` `"3:2"` `"3:4"` `"4:3"` `"4:5"` `"5:4"` `"9:16"` `"16:9"` `"21:9"`
`resolution`	Target output resolution. For 2K/4K the native Gemini upscaler is used.	COMBO	Yes	`"1K"` `"2K"` `"4K"`
`response_modalities`	Choose ‘IMAGE’ for image-only output, or ‘IMAGE+TEXT’ to return both the generated image and a text response.	COMBO	Yes	`"IMAGE+TEXT"` `"IMAGE"`
`images`	Optional reference image(s). To include multiple images, use the Batch Images node (up to 14).	IMAGE	No	N/A
`files`	Optional file(s) to use as context for the model. Accepts inputs from the Gemini Generate Content Input Files node.	CUSTOM	No	N/A
`system_prompt`	Foundational instructions that dictate an AI’s behavior. Default: A pre-defined system prompt for image generation.	STRING	No	N/A

Constraints:

The images input supports a maximum of 14 images. If more are provided, an error will be raised.
The files input must be connected to a node that outputs the GEMINI_INPUT_FILES data type.

Outputs

Output Name	Description	Data Type
`image`	The image generated or edited by the Gemini model.	IMAGE
`string`	The text response from the model. This output will be empty if `response_modalities` is set to “IMAGE”.	STRING

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): 5814a952815288c0b4b5962f646c69b0e618bfb9ab92b31ba60eab313c68a01c

​Inputs

​Outputs

Inputs

Outputs