Grok Image Edit - ComfyUI Built-in Node Documentation

Modify one or more existing images based on a text prompt. The node sends the connected reference image(s) and the prompt to the Grok image editing API using the selected model, then returns the edited image(s).

Inputs

Common Inputs

Parameter	Description	Data Type	Required	Range
`model`	The Grok image model to use. The sub-parameters shown below change depending on the selected model.	DYNAMIC_COMBO	Yes	”grok-imagine-image-2.0" "grok-imagine-image-quality" "grok-imagine-image-pro" "grok-imagine-image”
`prompt`	The text prompt used to generate the image. (default: "")	STRING	Yes	N/A
`seed`	Seed to determine if node should re-run; actual results are nondeterministic regardless of seed. (default: 0)	INT	Yes	0 to 2147483647

Note: grok-imagine-image-quality and grok-imagine-image-pro are retired by xAI and now run as grok-imagine-image-2.0 at low quality.

grok-imagine-image-2.0 Inputs

Parameter	Description	Data Type	Required	Range
`resolution`	Output resolution of the edited images.	COMBO	Yes	”1K" "2K”
`number_of_images`	Number of edited images to generate. (default: 1)	INT	Yes	1 to 10
`quality`	Quality level of the generated images.	COMBO	Yes	”medium" "low”
`aspect_ratio`	Aspect ratio of the edited image. (default: “auto”)	COMBO	Yes	”auto" "1:1" "2:3" "3:2" "3:4" "4:3" "9:16" "16:9" "9:19.5" "19.5:9" "9:20" "20:9" "1:2" "2:1”

grok-imagine-image-quality Inputs

Parameter	Description	Data Type	Required	Range
`resolution`	Output resolution of the edited images.	COMBO	Yes	”1K" "2K”
`number_of_images`	Number of edited images to generate. (default: 1)	INT	Yes	1 to 10
`aspect_ratio`	Aspect ratio of the edited image. (default: “auto”)	COMBO	Yes	”auto" "1:1" "2:3" "3:2" "3:4" "4:3" "9:16" "16:9" "9:19.5" "19.5:9" "9:20" "20:9" "1:2" "2:1”

grok-imagine-image Inputs

Parameter	Description	Data Type	Required	Range
`resolution`	Output resolution of the edited images.	COMBO	Yes	”1K" "2K”
`number_of_images`	Number of edited images to generate. (default: 1)	INT	Yes	1 to 10
`aspect_ratio`	Only allowed when multiple images are connected. (default: “auto”)	COMBO	Yes	”auto" "1:1" "2:3" "3:2" "3:4" "4:3" "9:16" "16:9" "9:19.5" "19.5:9" "9:20" "20:9" "1:2" "2:1”

grok-imagine-image-pro Inputs

Parameter	Description	Data Type	Required	Range
`resolution`	Output resolution of the edited images.	COMBO	Yes	”1K" "2K”
`number_of_images`	Number of edited images to generate. (default: 1)	INT	Yes	1 to 10

Reference Inputs

Parameter	Description	Data Type	Required	Range
`images`	Growable slot: connect 1 to N reference images to edit. The slots use the template names `image_1`, `image_2`, `image_3`; the maximum number of slots depends on the selected model.	IMAGE	Yes	1 image for `grok-imagine-image-pro` 1 to 3 images for `grok-imagine-image-2.0`, `grok-imagine-image-quality`, and `grok-imagine-image`

Note on constraints:

prompt must contain at least 1 non-whitespace character.
At least one reference image is required for editing; the node raises an error if no image is connected.
The maximum number of input images is 1 for grok-imagine-image-pro and 3 for grok-imagine-image-2.0, grok-imagine-image-quality, and grok-imagine-image. Connecting more images than the model supports raises an error.
The image limit counts every image in the connected inputs, so a batch containing several images counts as several images toward the limit.
For grok-imagine-image, a custom aspect_ratio (anything other than “auto”) is only allowed when multiple images are connected. With a single image, aspect_ratio must be “auto”.
For grok-imagine-image-2.0 and grok-imagine-image-quality, aspect_ratio can be set freely even with a single image.
The quality sub-parameter is only available with grok-imagine-image-2.0.

Outputs

Output Name	Description	Data Type
`IMAGE`	The edited image(s) returned by the Grok API. If a single image is generated, it is returned directly. If multiple images are generated, they are concatenated into a single batch tensor.	IMAGE

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): b8f4a86a3dd3a9cf1a24531fad4c62642e4c6de75a598fbe263ff8d3d16800d5

​Inputs

​Common Inputs

​grok-imagine-image-2.0 Inputs

​grok-imagine-image-quality Inputs

​grok-imagine-image Inputs

​grok-imagine-image-pro Inputs

​Reference Inputs

​Outputs