> ## 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.

# OpenAIGPTImageNodeV2 - ComfyUI Built-in Node Documentation

> Complete documentation for the OpenAIGPTImageNodeV2 node in ComfyUI. Learn its inputs, outputs, parameters and usage.

## 概述

此节点使用 OpenAI 的 GPT 图像 API 生成图像。它支持多种模型，允许您提供输入图像进行编辑，并可使用遮罩指定要修改的图像区域。

## 输入

| 参数                    | 描述                                                              | 数据类型   | 必填 | 范围                                                                                                                                                                               |
| --------------------- | --------------------------------------------------------------- | ------ | -- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `提示词`                 | GPT 图像的文本提示（默认值：""）。                                            | STRING | 是  | 无                                                                                                                                                                                |
| `模型`                  | 要使用的 OpenAI GPT 图像模型。选择模型后会显示该模型特有的附加参数。                        | COMBO  | 是  | `"gpt-image-2"`<br />`"gpt-image-1.5"`<br />`"gpt-image-1"`                                                                                                                      |
| `model.size`          | 图像尺寸。选择"Custom"可使用自定义宽度和高度（默认值："auto"）。仅适用于 `gpt-image-2`。      | COMBO  | 是  | `"auto"`<br />`"1024x1024"`<br />`"1024x1536"`<br />`"1536x1024"`<br />`"2048x2048"`<br />`"2048x1152"`<br />`"1152x2048"`<br />`"3840x2160"`<br />`"2160x3840"`<br />`"Custom"` |
| `model.custom_width`  | 仅在 `size` 为"Custom"时使用。必须是 16 的倍数（默认值：1024）。仅适用于 `gpt-image-2`。 | INT    | 否  | 1024 至 3840                                                                                                                                                                      |
| `model.custom_height` | 仅在 `size` 为"Custom"时使用。必须是 16 的倍数（默认值：1024）。仅适用于 `gpt-image-2`。 | INT    | 否  | 1024 至 3840                                                                                                                                                                      |
| `model.background`    | 返回带或不带背景的图像（默认值："auto"）。仅适用于 `gpt-image-2`。                     | COMBO  | 是  | `"auto"`<br />`"opaque"`                                                                                                                                                         |
| `model.quality`       | 生成图像的质量。仅适用于 `gpt-image-2`。                                     | COMBO  | 是  | `"standard"`<br />`"hd"`                                                                                                                                                         |
| `model.images`        | 用于编辑的输入图像。仅适用于 `gpt-image-2`。                                   | IMAGE  | 否  | 无                                                                                                                                                                                |
| `model.mask`          | 用于指定输入图像中要编辑区域的遮罩。仅适用于 `gpt-image-2`。                           | MASK   | 否  | 无                                                                                                                                                                                |
| `数量`                  | 要生成的图像数量（默认值：1）。                                                | INT    | 是  | 1 至 8                                                                                                                                                                            |
| `种子`                  | 用于结果可复现的随机种子（默认值：0）。注意：后端尚未实现此功能。                               | INT    | 是  | 0 至 2147483647                                                                                                                                                                   |

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

* 当使用 `gpt-image-2` 且 `model.size` 设置为"Custom"时，`custom_width` 和 `custom_height` 必须是 16 的倍数，最大边长不得超过 3840，宽高比不得超过 3:1，总像素数必须在 655,360 到 8,294,400 之间。
* 如果提供了 `mask`，则必须同时提供输入图像（`model.images`）。没有输入图像时不能使用遮罩。
* 遮罩不能与多个输入图像同时使用。
* 使用遮罩时，遮罩尺寸必须与输入图像尺寸一致。
* `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):** `a757208cf6cc151594599b35b0ef73f2caf7274189e948799211c0714a6a8f89`