OpenAI GPT Image 2.5 - ComfyUI Built-in Node Documentation

Este nodo genera imágenes mediante la API GPT Image de OpenAI. Admite cinco modelos —gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2, gpt-image-1.5 y gpt-image-1—, permite adjuntar imágenes de referencia para la edición de imágenes y puede usar una máscara para especificar qué partes de una imagen se deben reemplazar.

Entradas

Entradas comunes

Estas entradas siempre están visibles.

Parámetro	Descripción	Tipo de datos	Obligatorio	Rango
`modelo`	El modelo OpenAI GPT Image que se usará. Al seleccionar un modelo, se revelan parámetros adicionales específicos de ese modelo.	DYNAMIC_COMBO	Sí	`"gpt-image-2.5-flare"` `"gpt-image-2.5-sunburst"` `"gpt-image-2"` `"gpt-image-1.5"` `"gpt-image-1"`
`prompt`	Indicación de texto para GPT Image (predeterminado: `""`).	STRING	Sí	N/A
`n`	Cuántas imágenes generar (predeterminado: `1`).	INT	Sí	1 a 8
`semilla`	Semilla para reproducibilidad (predeterminado: `0`). Aún no implementado en el backend.	INT	Sí	0 a 2147483647

Entradas de gpt-image-2.5-flare y gpt-image-2.5-sunburst

Estas entradas aparecen cuando model se establece en gpt-image-2.5-flare o gpt-image-2.5-sunburst. Ambos modelos comparten el mismo conjunto de parámetros.

Parámetro	Descripción	Tipo de datos	Obligatorio	Rango
`tamaño`	Tamaño de imagen. Seleccione “Custom” para usar el ancho y el alto personalizados (predeterminado: `"auto"`).	COMBO	Sí	`"auto"` `"1024x1024"` `"1024x1536"` `"1536x1024"` `"2048x2048"` `"2048x1152"` `"1152x2048"` `"3840x2160"` `"2160x3840"` `"Custom"`
`ancho_personalizado`	Se usa solo cuando `model.size` es “Custom”. Debe ser múltiplo de 16 (predeterminado: `1024`).	INT	No	480 a 3840 (paso 16)
`altura_personalizada`	Se usa solo cuando `model.size` es “Custom”. Debe ser múltiplo de 16 (predeterminado: `1024`).	INT	No	480 a 3840 (paso 16)
`fondo`	Devuelve la imagen con o sin fondo (predeterminado: `"auto"`).	COMBO	Sí	`"auto"` `"opaque"` `"transparent"`
`calidad`	Calidad de imagen; afecta el costo y el tiempo de generación (predeterminado: `"low"`).	COMBO	Sí	`"low"` `"medium"` `"high"` `"xhigh"` `"max"`
`model.images`	Imagen o imágenes de referencia opcionales para la edición de imágenes. Hasta 16 imágenes. Consulte Entradas de referencia para obtener más detalles.	IMAGE	No	0 a 16
`model.mask`	Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia.	MASK	No	N/A

Entradas de gpt-image-2

Estas entradas aparecen cuando model se establece en gpt-image-2.

Parámetro	Descripción	Tipo de datos	Obligatorio	Rango
`tamaño`	Tamaño de imagen. Seleccione “Custom” para usar el ancho y el alto personalizados (predeterminado: `"auto"`).	COMBO	Sí	`"auto"` `"1024x1024"` `"1024x1536"` `"1536x1024"` `"2048x2048"` `"2048x1152"` `"1152x2048"` `"3840x2160"` `"2160x3840"` `"Custom"`
`ancho_personalizado`	Se usa solo cuando `model.size` es “Custom”. Debe ser múltiplo de 16 (predeterminado: `1024`).	INT	No	480 a 3840 (paso 16)
`altura_personalizada`	Se usa solo cuando `model.size` es “Custom”. Debe ser múltiplo de 16 (predeterminado: `1024`).	INT	No	480 a 3840 (paso 16)
`fondo`	Devuelve la imagen con o sin fondo (predeterminado: `"auto"`).	COMBO	Sí	`"auto"` `"opaque"`
`calidad`	Calidad de imagen; afecta el costo y el tiempo de generación (predeterminado: `"low"`).	COMBO	Sí	`"low"` `"medium"` `"high"`
`model.images`	Imagen o imágenes de referencia opcionales para la edición de imágenes. Hasta 16 imágenes. Consulte Entradas de referencia para obtener más detalles.	IMAGE	No	0 a 16
`model.mask`	Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia.	MASK	No	N/A

Entradas de gpt-image-1.5 y gpt-image-1

Estas entradas aparecen cuando model se establece en gpt-image-1.5 o gpt-image-1. Ambos modelos comparten el mismo conjunto de parámetros.

Parámetro	Descripción	Tipo de datos	Obligatorio	Rango
`tamaño`	Tamaño de imagen (predeterminado: `"auto"`).	COMBO	Sí	`"auto"` `"1024x1024"` `"1024x1536"` `"1536x1024"`
`fondo`	Devuelve la imagen con o sin fondo (predeterminado: `"auto"`).	COMBO	Sí	`"auto"` `"opaque"` `"transparent"`
`calidad`	Calidad de imagen; afecta el costo y el tiempo de generación (predeterminado: `"low"`).	COMBO	Sí	`"low"` `"medium"` `"high"`
`model.images`	Imagen o imágenes de referencia opcionales para la edición de imágenes. Hasta 16 imágenes. Consulte Entradas de referencia para obtener más detalles.	IMAGE	No	0 a 16
`model.mask`	Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia.	MASK	No	N/A

Entradas de referencia

Parámetro	Descripción	Tipo de datos	Obligatorio	Rango
`model.images`	Ranura ampliable: conecte de 1..N elementos (p. ej., `image_1`…`image_16`); hasta 16 imágenes de referencia para todos los modelos.	IMAGE	No	0 a 16
`model.mask`	Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia.	MASK	No	N/A

Restricciones y limitaciones de los parámetros:

Cuando model.size es “Custom” (solo gpt-image-2.5-flare, gpt-image-2.5-sunburst y gpt-image-2), model.custom_width y model.custom_height deben ser ambos múltiplos de 16, el borde más largo no debe superar 3840, la relación de aspecto no debe superar 3:1 y la cantidad total de píxeles debe estar entre 655.360 y 8.294.400.
model.mask requiere exactamente una imagen de referencia en model.images: no se puede usar sin una imagen y no se puede usar con más de una imagen.
Cuando se usa model.mask, su altura y anchura deben coincidir con la altura y anchura de la imagen de referencia.
Cuando se proporciona model.images, el nodo se ejecuta en modo de edición de imágenes; sin model.images, genera imágenes solo a partir del prompt.
Las imágenes de referencia y la máscara se reescalan a una resolución menor antes de enviarse a la API.
Los niveles de calidad "xhigh" y "max" solo están disponibles para gpt-image-2.5-flare y gpt-image-2.5-sunburst.
seed actualmente no está implementado en el backend.

Salidas

Nombre de salida	Descripción	Tipo de datos
`image`	La imagen o imágenes generadas. Todas las imágenes devueltas se apilan en un lote; si sus dimensiones difieren, se redimensionan para coincidir con la primera imagen.	IMAGE

Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! Editar en GitHub

Source fingerprint (SHA-256): 9cf1a9fa3e2cd98aff6c42432164ac5e6c55b7bcdc9815043cb359c6968ac172

​Entradas

​Entradas comunes

​Entradas de gpt-image-2.5-flare y gpt-image-2.5-sunburst

​Entradas de gpt-image-2

​Entradas de gpt-image-1.5 y gpt-image-1

​Entradas de referencia

​Salidas