GeminiImage2Node - ComfyUI Built-in Node Documentation

Generate or edit images synchronously through the Google Vertex AI Gemini API. You provide a text prompt and can optionally attach reference images or Gemini input files. The node returns the generated image and, depending on the selected response mode, a text response.

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. The prompt must contain at least one character after whitespace is removed.	STRING	Yes	N/A
`model`	The Gemini model to use for generation. The “Nano Banana 2 (Gemini 3.1 Flash Image)” option is sent as `gemini-3.1-flash-image`; “gemini-3-pro-image-preview” is sent as `gemini-3-pro-image`.	COMBO	Yes	”gemini-3-pro-image-preview" "Nano Banana 2 (Gemini 3.1 Flash Image)“
`seed`	When the seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn’t guaranteed. Also, changing the model or parameter settings, such as the temperature, can cause variations in the response even when you use the same seed value. By default, a random seed value is used. Default: 42.	INT	Yes	0 to 18446744073709551615
`aspect_ratio`	If set to ‘auto’, 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. Advanced setting.	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.	GEMINI_INPUT_FILES	No	N/A
`system_prompt`	Foundational instructions that dictate an AI’s behavior. Default: a pre-defined system prompt for image generation. Advanced setting.	STRING	No	N/A

Constraints:

The images input supports a maximum of 14 images. If more are provided, an error is raised.
When more than 10 images are provided, the first 10 are uploaded as URL references and the remaining images are sent inline in the request.
The files input must be connected to a node that outputs the GEMINI_INPUT_FILES data type.
When response_modalities is set to "IMAGE", only the image is returned and the text output is empty.
The prompt input is validated and must contain at least one character after whitespace is removed.

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 is 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): 02293dad786d4b441da3174fa76f6c5847f122d294bd7e1f765ffd72420034a4

​Inputs

​Outputs

Inputs

Outputs