内置节点参考

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)
  • maskimage 必须具有相同尺寸
  • 自定义分辨率(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

官方原文

本页来自 Comfy-Org 官方中文文档的固定版本,并转换为 xueai 静态页面。内容以官方持续更新的页面为准。

内容授权与修改

官方文档采用 GPL-3.0。本站保留许可证、固定提交号和修改说明,不代表 ComfyUI 或 Comfy-Org 对本站背书。

GPL-3.0来源和修改说明