> ## 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.
# OpenAIGPTImageNodeV2 - ComfyUI Built-in Node Documentation
> 此节点使用 OpenAI 的 GPT Image API 生成图像。
此节点使用 OpenAI 的 GPT Image API 生成图像。它支持五种模型 — `gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、`gpt-image-2`、`gpt-image-1.5` 和 `gpt-image-1` — 允许附加参考图像进行图像编辑，并可使用蒙版指定图像中需要替换的部分。
## 输入
### 通用输入
这些输入始终可见。
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| ----- | -------------------------------------------- | -------------- | -- | ------------------------------------------------------------------------------------------------------------------------ |
| `模型` | 要使用的 OpenAI GPT Image 模型。选择模型后会显示该模型特有的其他参数。 | DYNAMIC\_COMBO | 是 | `"gpt-image-2.5-flare"`
`"gpt-image-2.5-sunburst"`
`"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` |
| `提示词` | GPT Image 的文本提示词（默认值：`""`）。 | STRING | 是 | N/A |
| `数量` | 要生成的图像数量（默认值：`1`）。 | INT | 是 | 1到8 |
| `种子` | 用于结果可复现的随机种子（默认值：`0`）。后端尚未实现此参数。 | INT | 是 | 0到2147483647 |
### gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 输入
当 `model` 设置为 `gpt-image-2.5-flare` 或 `gpt-image-2.5-sunburst` 时显示这些输入。两个模型共享同一组参数。
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| -------------- | ---------------------------------------------------- | ----- | -- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `尺寸` | 图像尺寸。选择“Custom”可使用自定义宽度和高度（默认值：`"auto"`）。 | COMBO | 是 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` |
| `自定义宽度` | 仅当 `model.size` 为“Custom”时使用。必须是 16 的倍数（默认值：`1024`）。 | INT | 否 | 480到3840（步长 16） |
| `自定义高度` | 仅当 `model.size` 为“Custom”时使用。必须是 16 的倍数（默认值：`1024`）。 | INT | 否 | 480到3840（步长 16） |
| `背景` | 返回带或不带背景的图像（默认值：`"auto"`）。 | COMBO | 是 | `"auto"`
`"opaque"`
`"transparent"` |
| `质量` | 图像质量，影响成本和生成时间（默认值：`"low"`）。 | COMBO | 是 | `"low"`
`"medium"`
`"high"`
`"xhigh"`
`"max"` |
| `model.images` | 用于图像编辑的可选参考图像。最多 16 张。详见“参考输入”。 | IMAGE | 否 | 0到16 |
| `model.mask` | 用于局部重绘的可选蒙版（白色区域将被替换）。必须恰好有一张参考图像。 | MASK | 否 | N/A |
### gpt-image-2 输入
当 `model` 设置为 `gpt-image-2` 时显示这些输入。
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| -------------- | ---------------------------------------------------- | ----- | -- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `尺寸` | 图像尺寸。选择“Custom”可使用自定义宽度和高度（默认值：`"auto"`）。 | COMBO | 是 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` |
| `自定义宽度` | 仅当 `model.size` 为“Custom”时使用。必须是 16 的倍数（默认值：`1024`）。 | INT | 否 | 480到3840（步长 16） |
| `自定义高度` | 仅当 `model.size` 为“Custom”时使用。必须是 16 的倍数（默认值：`1024`）。 | INT | 否 | 480到3840（步长 16） |
| `背景` | 返回带或不带背景的图像（默认值：`"auto"`）。 | COMBO | 是 | `"auto"`
`"opaque"` |
| `质量` | 图像质量，影响成本和生成时间（默认值：`"low"`）。 | COMBO | 是 | `"low"`
`"medium"`
`"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"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` |
| `背景` | 返回带或不带背景的图像（默认值：`"auto"`）。 | COMBO | 是 | `"auto"`
`"opaque"`
`"transparent"` |
| `质量` | 图像质量，影响成本和生成时间（默认值：`"low"`）。 | COMBO | 是 | `"low"`
`"medium"`
`"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.5-flare`、`gpt-image-2.5-sunburst` 和 `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 之前会被缩小。
* `"xhigh"` 和 `"max"` 质量等级仅适用于 `gpt-image-2.5-flare` 和 `gpt-image-2.5-sunburst`。
* `"transparent"` 背景选项可用于 `gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、`gpt-image-1.5` 和 `gpt-image-1`，但不适用于 `gpt-image-2`。
* `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):** `4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148`