ComfyPilotComfyPilot
文档 / 节点说明 / Grok 图像编辑

Grok 图像编辑

基于文本提示修改一张或多张现有图像。此节点使用所选模型将连接的参考图像和提示发送到 Grok 图像编辑 API，然后返回编辑后的图像。

节点说明 GrokImageEditNodeV2 更新于 2026-11-12

查看官方原文

Grok 图像编辑 - ComfyUI Built-in Node Documentation

基于文本提示修改一张或多张现有图像。此节点使用所选模型将连接的参考图像和提示发送到 Grok 图像编辑 API，然后返回编辑后的图像。

基于文本提示修改一张或多张现有图像。此节点使用所选模型将连接的参考图像和提示发送到 Grok 图像编辑 API，然后返回编辑后的图像。

输入

通用输入

参数描述数据类型必需范围
模型要使用的 Grok 图像模型。下面显示的子参数会随所选模型而变化。DYNAMIC\_COMBO是"grok-imagine-image-2.0" "grok-imagine-image-quality" "grok-imagine-image-pro" "grok-imagine-image"
提示词用于生成图像的文本提示。(默认: "")STRING是N/A
种子用于确定节点是否应重新运行的种子；无论种子如何，实际结果都是非确定性的。(默认: 0)INT是0 到 2147483647

注意： grok-imagine-image-quality 和 grok-imagine-image-pro 已被 xAI 停用，现在以 grok-imagine-image-2.0 的低质量档运行。

grok-imagine-image-2.0 输入

参数描述数据类型必需范围
resolution编辑后图像的输出分辨率。COMBO是"1K" "2K"
number_of_images要生成的编辑图像数量。(默认: 1)INT是1 到 10
quality生成图像的质量级别。COMBO是"medium" "low"
aspect_ratio编辑后图像的宽高比。(默认: "auto")COMBO是"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 输入

参数描述数据类型必需范围
resolution编辑后图像的输出分辨率。COMBO是"1K" "2K"
number_of_images要生成的编辑图像数量。(默认: 1)INT是1 到 10
aspect_ratio编辑后图像的宽高比。(默认: "auto")COMBO是"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 输入

参数描述数据类型必需范围
resolution编辑后图像的输出分辨率。COMBO是"1K" "2K"
number_of_images要生成的编辑图像数量。(默认: 1)INT是1 到 10
aspect_ratio仅当连接多张图像时才允许。(默认: "auto")COMBO是"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 输入

参数描述数据类型必需范围
resolution编辑后图像的输出分辨率。COMBO是"1K" "2K"
number_of_images要生成的编辑图像数量。(默认: 1)INT是1 到 10

参考输入

参数描述数据类型必需范围
images可增长槽位：连接 1 到 N 张要编辑的参考图像。槽位使用模板名称 image_1、image_2、image_3；最大槽位数取决于所选模型。IMAGE是1 张图像（适用于 grok-imagine-image-pro） 1 到 3 张图像（适用于 grok-imagine-image-2.0、grok-imagine-image-quality 和 grok-imagine-image）

约束说明：

  • prompt 必须包含至少 1 个非空白字符。
  • 编辑时至少需要一张参考图像；如果未连接任何图像，节点会报错。
  • 输入图像的最大数量为：grok-imagine-image-pro 为 1 张，grok-imagine-image-2.0、grok-imagine-image-quality 和 grok-imagine-image 为 3 张。连接超过模型支持数量的图像会报错。
  • 图像限制会计算连接输入中的每一张图像，因此包含多张图像的批次会按多张图像计入限制。
  • 对于 grok-imagine-image，仅当连接多张图像时，才允许自定义 aspect_ratio（任何非 "auto" 的值）。如果只有一张图像，aspect_ratio 必须为 "auto"。
  • 对于 grok-imagine-image-2.0 和 grok-imagine-image-quality，即使只有一张图像，也可以自由设置 aspect_ratio。
  • quality 子参数仅适用于 grok-imagine-image-2.0。

输出

输出名称描述数据类型
IMAGEGrok API 返回的编辑后图像。如果生成单张图像，则直接返回。如果生成多张图像，则将其拼接为单个批次张量。IMAGE
本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑

Source fingerprint (SHA-256): b8f4a86a3dd3a9cf1a24531fad4c62642e4c6de75a598fbe263ff8d3d16800d5