> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-mintlify-theme-mint.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"`
`"transparent"` |
| `质量` | 图像质量，影响成本和生成时间（默认值：`"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 | 否 | 0 到 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`。
* `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):** `804ea35d0e2aa0b2993a293cb10cb41e2f9c6a3732304306253f7f7b1eb59b8a`