> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAIGPTImageNodeV2 - ComfyUI Built-in Node Documentation

> 此节点使用 OpenAI 的 GPT Image API 生成图像。

此节点使用 OpenAI 的 GPT Image API 生成图像。它支持多个模型（`gpt-image-2`、`gpt-image-1.5` 和 `gpt-image-1`），允许您提供参考图像进行编辑，并可利用遮罩指定要修改的图像区域。

## 输入

### 通用输入

| 参数    | 描述                                           | 数据类型           | 必填 | 范围                                                          |
| ----- | -------------------------------------------- | -------------- | -- | ----------------------------------------------------------- |
| `模型`  | 要使用的 OpenAI GPT Image 模型。选择模型后会显示该模型特有的附加参数。 | DYNAMIC\_COMBO | 是  | `"gpt-image-2"`<br />`"gpt-image-1.5"`<br />`"gpt-image-1"` |
| `提示词` | GPT Image 的文本提示（默认：`""`）。                    | STRING         | 是  | N/A                                                         |
| `数量`  | 生成图像的数量（默认：`1`）。                             | INT            | 是  | 1 到 8                                                       |
| `种子`  | 用于结果可复现的种子（默认：`0`）。后端暂未实现。                   | INT            | 是  | 0 到 2147483647                                              |

### gpt-image-2 输入

当 `model` 设置为 `gpt-image-2` 时，将显示这些输入。

| 参数             | 描述                                                    | 数据类型  | 必填 | 范围                                                                                                                                                                               |
| -------------- | ----------------------------------------------------- | ----- | -- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `尺寸`           | 图像尺寸。选择 "Custom" 以使用自定义宽度和高度（默认：`"auto"`）。            | COMBO | 是  | `"auto"`<br />`"1024x1024"`<br />`"1024x1536"`<br />`"1536x1024"`<br />`"2048x2048"`<br />`"2048x1152"`<br />`"1152x2048"`<br />`"3840x2160"`<br />`"2160x3840"`<br />`"Custom"` |
| `自定义宽度`        | 仅在 `model.size` 为 "Custom" 时使用。必须是 16 的倍数（默认：`1024`）。 | INT   | 否  | 1024 到 3840                                                                                                                                                                      |
| `自定义高度`        | 仅在 `model.size` 为 "Custom" 时使用。必须是 16 的倍数（默认：`1024`）。 | INT   | 否  | 1024 到 3840                                                                                                                                                                      |
| `背景`           | 返回带有或不带背景的图像（默认：`"auto"`）。                            | COMBO | 是  | `"auto"`<br />`"opaque"`                                                                                                                                                         |
| `质量`           | 图像质量，影响成本和生成时间（默认：`"low"`）。                           | COMBO | 是  | `"low"`<br />`"medium"`<br />`"high"`                                                                                                                                            |
| `model.images` | 用于图像编辑的可选参考图像。最多 16 张。有关详细信息，请参阅参考输入。                 | IMAGE | 否  | 0 到 16                                                                                                                                                                           |
| `model.mask`   | 用于局部重绘的可选遮罩（白色区域将被替换）。需要恰好一张参考图像。                     | MASK  | 否  | N/A                                                                                                                                                                              |

### gpt-image-1.5 和 gpt-image-1 输入

当 `model` 设置为 `gpt-image-1.5` 或 `gpt-image-1` 时，将显示这些输入。两个模型共用同一组参数。

| 参数             | 描述                                    | 数据类型  | 必填 | 范围                                                                |
| -------------- | ------------------------------------- | ----- | -- | ----------------------------------------------------------------- |
| `尺寸`           | 图像尺寸（默认：`"auto"`）。                    | COMBO | 是  | `"auto"`<br />`"1024x1024"`<br />`"1024x1536"`<br />`"1536x1024"` |
| `背景`           | 返回带有或不带背景的图像（默认：`"auto"`）。            | COMBO | 是  | `"auto"`<br />`"opaque"`<br />`"transparent"`                     |
| `质量`           | 图像质量，影响成本和生成时间（默认：`"low"`）。           | COMBO | 是  | `"low"`<br />`"medium"`<br />`"high"`                             |
| `model.images` | 用于图像编辑的可选参考图像。最多 16 张。有关详细信息，请参阅参考输入。 | IMAGE | 否  | 0 到 16                                                            |
| `model.mask`   | 用于局部重绘的可选遮罩（白色区域将被替换）。需要恰好一张参考图像。     | MASK  | 否  | N/A                                                               |

### 参考输入

| 参数             | 描述                                                               | 数据类型  | 必填 | 范围     |
| -------------- | ---------------------------------------------------------------- | ----- | -- | ------ |
| `model.images` | 可扩展插槽：可连接 1..N 个项目（例如 `image_1`...`image_16`）；所有模型最多支持 16 张参考图像。 | IMAGE | 否  | 1 到 16 |
| `model.mask`   | 用于局部重绘的可选遮罩（白色区域将被替换）。需要恰好一张参考图像。                                | MASK  | 否  | N/A    |

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

* 当 `model.size` 为 "Custom"（仅限 gpt-image-2）时，`model.custom_width` 和 `model.custom_height` 必须都是 16 的倍数，最长边不得超过 3840，宽高比不得超过 3:1，总像素数必须介于 655,360 和 8,294,400 之间。
* `model.mask` 需要恰好在 `model.images` 中提供一张参考图像：不能没有图像，也不能用于多张图像。
* 使用 `model.mask` 时，其尺寸必须与参考图像的尺寸一致。
* 当提供 `model.images` 时，节点运行在图像编辑模式；未提供 `model.images` 时，仅根据提示词生成图像。
* 参考图像在发送到 API 之前会被缩小。
* `seed` 目前尚未在后端实现。

## 输出

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

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

***

**Source fingerprint (SHA-256):** `fb3491f949151fbd3f5825ec9f9ae124019767d083f56966ef34af278aef50c0`