OpenAI GPT Image 2.5 - ComfyUI Built-in Node Documentation

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

Entradas

Entradas comunes

Estas entradas siempre están visibles.

Parámetro	Descripción	Tipo de datos	Obligatorio	Rango
`modelo`	El modelo GPT Image de OpenAI a usar. Al seleccionar un modelo se revelan parámetros adicionales específicos de ese modelo.	DYNAMIC_COMBO	Sí	`"gpt-image-2.6-flare"` `"gpt-image-2.6-sunburst"` `"gpt-image-2.5-flare"` `"gpt-image-2.5-sunburst"` `"gpt-image-2"` `"gpt-image-1.5"`
`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 implementada en el backend.	INT	Sí	0 a 2147483647

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

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

Parámetro	Descripción	Tipo de datos	Obligatorio	Rango
`tamaño`	Tamaño de la imagen. Seleccione “Custom” para usar el ancho y 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`	Devolver 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(es) de referencia opcional(es) para edición de imágenes. Hasta 16 imágenes. Consulte Entradas de referencia para más detalles.	IMAGE	No	0 a 16
`model.mask`	Máscara opcional para inpainting (las áreas blancas serán reemplazadas). Requiere exactamente una imagen de referencia.	MASK	No	N/A
`model.complexity`	Cuánto planifica el modelo la imagen antes de renderizar. Los valores más bajos devuelven más rápido, los valores más altos planifican más. Predeterminado: `"high"`.	COMBO	Sí	`"low"` `"medium"` `"high"`

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 la imagen. Seleccione “Custom” para usar el ancho y 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`	Devolver 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(es) de referencia opcional(es) para edición de imágenes. Hasta 16 imágenes. Consulte Entradas de referencia para más detalles.	IMAGE	No	0 a 16
`model.mask`	Máscara opcional para inpainting (las áreas blancas serán reemplazadas). 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 la imagen. Seleccione “Custom” para usar el ancho y 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`	Devolver 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(es) de referencia opcional(es) para edición de imágenes. Hasta 16 imágenes. Consulte Entradas de referencia para más detalles.	IMAGE	No	0 a 16
`model.mask`	Máscara opcional para inpainting (las áreas blancas serán reemplazadas). Requiere exactamente una imagen de referencia.	MASK	No	N/A

Entradas de gpt-image-1.5

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

Parámetro	Descripción	Tipo de datos	Obligatorio	Rango
`tamaño`	Tamaño de la imagen (predeterminado: `"auto"`).	COMBO	Sí	`"auto"` `"1024x1024"` `"1024x1536"` `"1536x1024"`
`fondo`	Devolver 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(es) de referencia opcional(es) para edición de imágenes. Hasta 16 imágenes. Consulte Entradas de referencia para más detalles.	IMAGE	No	0 a 16
`model.mask`	Máscara opcional para inpainting (las áreas blancas serán reemplazadas). 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 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 serán reemplazadas). 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.6-flare, gpt-image-2.6-sunburst, 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 exceder 3840, la relación de aspecto no debe exceder 3:1, y el recuento 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 ancho deben coincidir con la altura y el ancho 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 de la indicación.
Las imágenes de referencia y la máscara se reducen de escala antes de enviarse a la API.
Los niveles de calidad "xhigh" y "max" solo están disponibles para gpt-image-2.6-flare, gpt-image-2.6-sunburst, gpt-image-2.5-flare y gpt-image-2.5-sunburst.
model.complexity solo está disponible para gpt-image-2.6-flare y gpt-image-2.6-sunburst; los otros modelos usan una profundidad de planificación fija.
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): 36e8dbe4e35d0473ccf16482f640769e8bc30c345bc062a6785a48d7336efa03