> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# GrokImageEditNodeV2 - ComfyUI Built-in Node Documentation
> 基于文本提示修改一张或多张现有图像。
基于文本提示修改一张或多张现有图像。此节点使用所选模型将连接的参考图像和提示发送到 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-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 和 grok-imagine-image 输入
由 grok-imagine-image-quality 和 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-quality` 和 `grok-imagine-image`，仅当连接多张图像时，才允许自定义 `aspect_ratio`（任何非 "auto" 的值）。如果只有一张图像，`aspect_ratio` 必须为 "auto"。
* 对于 `grok-imagine-image-2.0`，即使只有一张图像，也可以自由设置 `aspect_ratio`。
* `quality` 子参数仅适用于 `grok-imagine-image-2.0`。
## 输出
| 输出名称 | 描述 | 数据类型 |
| ------- | ------------------------------------------------------- | ----- |
| `IMAGE` | Grok API 返回的编辑后图像。如果生成单张图像，则直接返回。如果生成多张图像，则将其拼接为单个批次张量。 | IMAGE |
> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GrokImageEditNodeV2/zh.md)
***
**Source fingerprint (SHA-256):** `7d75b1cb8405c5024567b1119bcbd5e4b318152605f74b62bdd5173dda75949f`