通过 OpenAI 的 GPT 图像端点同步生成图像。此节点可以根据文本提示创建新图像，或在提供输入图像和可选遮罩时编辑现有图像。它支持多种 GPT 图像模型，包括 gpt-image-1、gpt-image-1.5 和 gpt-image-2。

## 输入

| 参数 | 描述 | 数据类型 | 是否必填 | 范围 |
| --- | --- | --- | --- | --- |
| `提示词` | GPT 图像的文本提示（默认：""） | STRING | 是 | - |
| `种子` | 生成的随机种子（默认：0）——后端尚未实现 | INT | 否 | 0 到 2147483647 |
| `质量` | 图像质量，影响成本和生成时间（默认："low"） | COMBO | 否 | "low"<br>"medium"<br>"high" |
| `背景` | 返回带或不带背景的图像（默认："auto"） | COMBO | 否 | "auto"<br>"opaque"<br>"transparent" |
| `尺寸` | 图像尺寸。选择"Custom"以使用自定义宽度和高度（仅限 GPT Image 2）（默认："auto"） | COMBO | 否 | "auto"<br>"1024x1024"<br>"1024x1536"<br>"1536x1024"<br>"2048x2048"<br>"2048x1152"<br>"1152x2048"<br>"3840x2160"<br>"2160x3840"<br>"Custom" |
| `数量` | 生成图像的数量（默认：1） | INT | 否 | 1 到 8 |
| `参考图像` | 用于图像编辑的可选参考图像 | IMAGE | 否 | - |
| `遮罩` | 用于修复的可选遮罩（白色区域将被替换） | MASK | 否 | - |
| `模型` | 使用的 GPT 图像模型（默认："gpt-image-2"） | COMBO | 否 | "gpt-image-1"<br>"gpt-image-1.5"<br>"gpt-image-2" |
| `custom_width` | 仅当 `尺寸` 为"Custom"时使用。必须是 16 的倍数（仅限 GPT Image 2）（默认：1024） | INT | 否 | 1024 到 3840 |
| `custom_height` | 仅当 `尺寸` 为"Custom"时使用。必须是 16 的倍数（仅限 GPT Image 2）（默认：1024） | INT | 否 | 1024 到 3840 |

**参数约束：**

- 当提供 `image` 时，节点切换到图像编辑模式
- `mask` 仅在提供 `image` 时才能使用
- 使用 `mask` 时，仅支持单张图像（批次大小必须为 1）
- `mask` 和 `image` 必须具有相同尺寸
- 自定义分辨率（`size` = "Custom"）仅由 gpt-image-2 模型支持
- 自定义宽度和高度必须是 16 的倍数
- 自定义分辨率的宽高比不得超过 3:1
- 自定义分辨率的总像素数必须在 655,360 到 8,294,400 之间
- gpt-image-2 模型不支持透明背景
- 大于 1536x1024 的尺寸（例如 2048x2048、3840x2160）仅由 gpt-image-2 模型支持

## 输出

| 输出名称 | 描述 | 数据类型 |
| --- | --- | --- |
| `IMAGE` | 生成或编辑的图像 | IMAGE |

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

---
**Source fingerprint (SHA-256):** `44b258d6afcb388db3836427abdd5a7cb5c09a0328efceef7e114dd61a38eae1`