OpenAIGPTImage1 - ComfyUI Built-in Node Documentation

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

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

​

输入

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

---

Source fingerprint (SHA-256): 44b258d6afcb388db3836427abdd5a7cb5c09a0328efceef7e114dd61a38eae1