内置节点参考

OpenAIGPTImageNodeV2 - ComfyUI Built-in Node Documentation

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

概述

此节点使用 OpenAI 的 GPT 图像 API 生成图像。它支持多种模型,允许您提供输入图像进行编辑,并可使用遮罩指定要修改的图像区域。

输入

参数 描述 数据类型 必填 范围
提示词 GPT 图像的文本提示(默认值:"")。 STRING
模型 要使用的 OpenAI GPT 图像模型。选择模型后会显示该模型特有的附加参数。 COMBO "gpt-image-2"

"gpt-image-1.5" "gpt-image-1" | | model.size | 图像尺寸。选择"Custom"可使用自定义宽度和高度(默认值:"auto")。仅适用于 gpt-image-2。 | COMBO | 是 | "auto" "1024x1024" "1024x1536" "1536x1024" "2048x2048" "2048x1152" "1152x2048" "3840x2160" "2160x3840" "Custom" | | model.custom_width | 仅在 size 为"Custom"时使用。必须是 16 的倍数(默认值:1024)。仅适用于 gpt-image-2。 | INT | 否 | 1024 至 3840 | | model.custom_height | 仅在 size 为"Custom"时使用。必须是 16 的倍数(默认值:1024)。仅适用于 gpt-image-2。 | INT | 否 | 1024 至 3840 | | model.background | 返回带或不带背景的图像(默认值:"auto")。仅适用于 gpt-image-2。 | COMBO | 是 | "auto" "opaque" | | model.quality | 生成图像的质量。仅适用于 gpt-image-2。 | COMBO | 是 | "standard" "hd" | | model.images | 用于编辑的输入图像。仅适用于 gpt-image-2。 | IMAGE | 否 | 无 | | model.mask | 用于指定输入图像中要编辑区域的遮罩。仅适用于 gpt-image-2。 | MASK | 否 | 无 | | 数量 | 要生成的图像数量(默认值:1)。 | INT | 是 | 1 至 8 | | 种子 | 用于结果可复现的随机种子(默认值:0)。注意:后端尚未实现此功能。 | INT | 是 | 0 至 2147483647 |

参数约束与限制:

  • 当使用 gpt-image-2model.size 设置为"Custom"时,custom_widthcustom_height 必须是 16 的倍数,最大边长不得超过 3840,宽高比不得超过 3:1,总像素数必须在 655,360 到 8,294,400 之间。
  • 如果提供了 mask,则必须同时提供输入图像(model.images)。没有输入图像时不能使用遮罩。
  • 遮罩不能与多个输入图像同时使用。
  • 使用遮罩时,遮罩尺寸必须与输入图像尺寸一致。
  • seed 参数目前无效。

输出

输出名称 描述 数据类型
image 生成的图像或图像集。 IMAGE

本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑


Source fingerprint (SHA-256): a757208cf6cc151594599b35b0ef73f2caf7274189e948799211c0714a6a8f89

官方原文

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

内容授权与修改

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

GPL-3.0来源和修改说明