# OpenAI GPT 图像 2.5

此节点使用 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"`<br>`"gpt-image-2.5-sunburst"`<br>`"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.5-flare 和 gpt-image-2.5-sunburst 输入

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

| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| --- | --- | --- | --- | --- |
| `尺寸` | 图像尺寸。选择 "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 | 否 | 480 到 3840 (步长 16) |
| `自定义高度` | 仅当 `model.size` 为 "Custom" 时使用。必须是 16 的倍数（默认值：`1024`）。 | INT | 否 | 480 到 3840 (步长 16) |
| `背景` | 返回带背景或不带背景的图像（默认值：`"auto"`）。 | COMBO | 是 | `"auto"`<br>`"opaque"`<br>`"transparent"` |
| `质量` | 图像质量，影响成本和生成时间（默认值：`"low"`）。 | COMBO | 是 | `"low"`<br>`"medium"`<br>`"high"`<br>`"xhigh"`<br>`"max"` |
| `model.images` | 用于图像编辑的可选参考图像。最多 16 张图像。详情请参阅参考输入。 | IMAGE | 否 | 0 到 16 |
| `model.mask` | 用于修复的可选蒙版（白色区域将被替换）。需要恰好一张参考图像。 | MASK | 否 | N/A |

### 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 | 否 | 480 到 3840 (步长 16) |
| `自定义高度` | 仅当 `model.size` 为 "Custom" 时使用。必须是 16 的倍数（默认值：`1024`）。 | INT | 否 | 480 到 3840 (步长 16) |
| `背景` | 返回带背景或不带背景的图像（默认值：`"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 | 否 | 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):** `9cf1a9fa3e2cd98aff6c42432164ac5e6c55b7bcdc9815043cb359c6968ac172`
