> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAIGPTImageNodeV3 - ComfyUI Built-in Node Documentation

> OpenAI GPT Image 2.6 使用 OpenAI 的 GPT Image 模型，根据提示词生成图像，并在连接参考图像时对它们进行编辑。

## 概述

OpenAI GPT Image 2.6 使用 OpenAI 的 GPT Image 模型，根据提示词生成图像，并在连接参考图像时对它们进行编辑。此节点提供四种模型：`gpt-image-2.6-flare`、`gpt-image-2.6-sunburst`、`gpt-image-2.5-flare` 和 `gpt-image-2.5-sunburst`。在第一张参考图像上绘制标注，并将它们作为标记对连接，即可向模型准确指示需要编辑的位置。

## 输入

### 通用输入

| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| - | - | - | - | - |
| `model` | 要使用的 GPT Image 模型。选择某个模型后会显示该模型对应的参数。 | DYNAMIC\_COMBO | 是 | `"gpt-image-2.6-flare"` `"gpt-image-2.6-sunburst"` `"gpt-image-2.5-flare"` `"gpt-image-2.5-sunburst"` |

### gpt-image-2.6-flare 和 gpt-image-2.6-sunburst 输入

当 `model` 设置为 `gpt-image-2.6-flare` 或 `gpt-image-2.6-sunburst` 时，这些输入会出现。两个模型共享相同的参数。

| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| - | - | - | - | - |
| `model.prompt` | 要生成的内容，或要进行的编辑。（默认：`""`） | STRING | 是 | N/A |
| `model.size` | 图像尺寸。选择 "Custom" 可使用自定义的宽度和高度。（默认：`"auto"`） | COMBO | 是 | `"auto"` `"1024x1024"` `"1024x1536"` `"1536x1024"` `"2048x2048"` `"2048x1152"` `"1152x2048"` `"3840x2160"` `"2160x3840"` `"Custom"` |
| `model.custom_width` | 仅在 `model.size` 为 "Custom" 时使用。必须为 16 的倍数。（默认：`1024`） | INT | 否 | 480 到 3840（步长 16） |
| `model.custom_height` | 仅在 `model.size` 为 "Custom" 时使用。必须为 16 的倍数。（默认：`1024`） | INT | 否 | 480 到 3840（步长 16） |
| `model.background` | 返回带背景或不带背景的图像。（默认：`"auto"`） | COMBO | 是 | `"auto"` `"opaque"` `"transparent"` |
| `model.quality` | 图像质量。级别越高，费用越高、耗时越长。（默认：`"low"`） | COMBO | 是 | `"low"` `"medium"` `"high"` `"xhigh"` `"max"` |
| `model.complexity` | 模型在渲染前对图像进行规划的程度。（默认：`"high"`） | COMBO | 是 | `"low"` `"medium"` `"high"` |
| `model.images` | 用于编辑的可选参考图像。最多 16 张。 | AUTOGROW | 否 | 0 到 16 |
| `model.markup` | 在第一张参考图像上绘制的标注，用于指示需要编辑的位置。必须与该图像的尺寸一致，并且必须与 `model.markup_alpha` 一同连接。 | IMAGE | 否 | N/A |
| `model.markup_alpha` | 白色用于标记 `model.markup` 中的标注。Painter 节点的 MASK 输出可直接使用；Load Image 的蒙版需先经过 Invert Mask。 | MASK | 否 | N/A |
| `model.seed` | 控制节点是否重新运行；无论种子如何，结果都是非确定性的。（默认：`42`） | INT | 是 | 0 到 2147483647 |

### gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 输入

当 `model` 设置为 `gpt-image-2.5-flare` 或 `gpt-image-2.5-sunburst` 时，这些输入会出现。它们与 2.6 模型相同，只是不提供 `model.complexity`。

| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| - | - | - | - | - |
| `model.prompt` | 要生成的内容，或要进行的编辑。（默认：`""`） | STRING | 是 | N/A |
| `model.size` | 图像尺寸。选择 "Custom" 可使用自定义的宽度和高度。（默认：`"auto"`） | COMBO | 是 | `"auto"` `"1024x1024"` `"1024x1536"` `"1536x1024"` `"2048x2048"` `"2048x1152"` `"1152x2048"` `"3840x2160"` `"2160x3840"` `"Custom"` |
| `model.custom_width` | 仅在 `model.size` 为 "Custom" 时使用。必须为 16 的倍数。（默认：`1024`） | INT | 否 | 480 到 3840（步长 16） |
| `model.custom_height` | 仅在 `model.size` 为 "Custom" 时使用。必须为 16 的倍数。（默认：`1024`） | INT | 否 | 480 到 3840（步长 16） |
| `model.background` | 返回带背景或不带背景的图像。（默认：`"auto"`） | COMBO | 是 | `"auto"` `"opaque"` `"transparent"` |
| `model.quality` | 图像质量。级别越高，费用越高、耗时越长。（默认：`"low"`） | COMBO | 是 | `"low"` `"medium"` `"high"` `"xhigh"` `"max"` |
| `model.images` | 用于编辑的可选参考图像。最多 16 张。 | AUTOGROW | 否 | 0 到 16 |
| `model.markup` | 在第一张参考图像上绘制的标注，用于指示需要编辑的位置。必须与该图像的尺寸一致，并且必须与 `model.markup_alpha` 一同连接。 | IMAGE | 否 | N/A |
| `model.markup_alpha` | 白色用于标记 `model.markup` 中的标注。Painter 节点的 MASK 输出可直接使用；Load Image 的蒙版需先经过 Invert Mask。 | MASK | 否 | N/A |
| `model.seed` | 控制节点是否重新运行；无论种子如何，结果都是非确定性的。（默认：`42`） | INT | 是 | 0 到 2147483647 |

**参数约束与限制：**

* 当 `model.size` 设为 "Custom" 时，`model.custom_width` 和 `model.custom_height` 都必须是 16 的倍数，最长边不得超过 3840，宽高比不得超过 3:1，总像素数必须在 655,360 到 8,294,400 之间。
* `model.markup` 和 `model.markup_alpha` 必须一同连接。标记需要至少一张参考图像，且其宽度和高度必须与第一张参考图像一致。
* 不连接 `model.images` 时，节点仅根据提示词生成图像；连接参考图像时，则会对这些图像进行编辑和组合。
* 参考图像在发送至 API 之前会被缩小。
* `model.complexity` 仅存在于 `gpt-image-2.6-flare` 和 `gpt-image-2.6-sunburst` 上；2.5 模型使用固定的规划深度。

## 输出

| 输出名称 | 描述 | 数据类型 |
| - | - | - |
| `image` | 生成的一张或多张图像。所有返回的图像会堆叠为一个批次；如果它们的尺寸不同，则会调整尺寸以匹配第一张图像。 | IMAGE |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV3/zh.md)

***

**Source fingerprint (SHA-256):** `33f5d91af56c215cc7f7c704f9b123fe1c35bf287012072b818b76b551c04667`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.