GPT Image 2.5 se utiliza en ComfyUI mediante un nodo oficial que llama a un servicio remoto. No hay que descargar un checkpoint de Flare o Sunburst. Necesitas una versión de ComfyUI que incluya el nodo, una cuenta de Comfy con saldo y un flujo que conecte su salida a Save Image. La guía oficial señala ComfyUI 0.35.0 o posterior y ofrece plantillas para generar y editar con ambos modelos. Tutorial oficial de GPT Image 2.5.
La distinción evita buena parte de los errores de instalación: un flujo de difusión local suele cargar modelos desde el disco; este nodo utiliza autenticación y créditos de Comfy para enviar la petición. Tu GPU puede intervenir en otros pasos del flujo, pero no ejecuta localmente GPT Image 2.5.
Hemos consultado la documentación y la implementación pública el 21 de septiembre de 2026. Lo que sigue describe ese funcionamiento; no procede de una prueba de generación de pago ni de una instalación local verificada.
La cuenta que necesita el nodo es la de Comfy
Antes de ajustar el encargo, abre Settings → User e inicia sesión en Comfy. Después comprueba el saldo en Settings → Credits: los Partner Nodes requieren un saldo superior a cero. Si accedes desde el mismo equipo mediante la dirección local admitida, puedes usar el inicio de sesión directo. Para acceso por red local u otros dominios no admitidos, la documentación indica el uso de una ComfyUI Account API Key. Acceso y créditos de Partner Nodes.
Esa clave identifica tu cuenta de Comfy. No es una clave del registro para publicar nodos y tampoco se sustituye por una clave de OpenAI, LaoZhang u otro proveedor.
| Lo que tienes | Qué permite en este flujo |
|---|---|
| Cuenta Comfy autenticada y créditos | Utilizar el Partner Node conforme a las condiciones de Comfy |
| ComfyUI Account API Key | Autenticar el acceso admitido por Comfy cuando corresponde usar esa vía |
| Clave de la API de OpenAI | Hacer llamadas directas a OpenAI con otra integración; no paga el nodo oficial de Comfy |
| Suscripción a ChatGPT | No sustituye la cuenta ni los créditos del Partner Node |
| Clave de un servicio compatible | Solo sirve en una integración que admita expresamente ese servicio |
La implementación consultada envía las peticiones a las rutas proxy de Comfy y utiliza su autenticación. No expone un campo público para cambiar arbitrariamente la URL base. Por tanto, pegar una clave de otro proveedor en un campo de cuenta Comfy no convierte este nodo en un cliente genérico de Images API. Código del nodo OpenAI.
Abre una plantilla y guarda la primera imagen
Actualiza ComfyUI a una versión compatible y reinícialo. En la biblioteca de plantillas, busca las opciones de GPT Image 2.5 indicadas por el tutorial oficial. Hay cuatro plantillas que cubren generación y edición con Flare y Sunburst. Si no aparecen, comprueba la versión instalada y el canal de actualización: una función puede llegar antes a las compilaciones de desarrollo que a una distribución estable.
El nodo se llama OpenAI GPT Image 2.5 y su identificador interno es OpenAIGPTImageNodeV2. Encontrarlo evita instalar un complemento de nombre parecido pensando que es un requisito del soporte oficial.
Para generar desde texto:
- Abre una plantilla de generación y comprueba que no haya imágenes de referencia conectadas.
- Elige
gpt-image-2.5-flareogpt-image-2.5-sunbursten el selector del nodo. - Escribe un encargo concreto, por ejemplo: «Fotografía de una mochila de senderismo naranja sobre una roca, luz suave de mañana, fondo de montaña desenfocado, sin texto».
- Empieza con una imagen, un tamaño predefinido y calidad
mediumpara reducir las variables de la prueba. - Conecta la salida IMAGE a Save Image, ejecuta y comprueba el archivo guardado.
Sin referencias, el nodo utiliza generación; con referencias conectadas, utiliza edición. Esa decisión está en la implementación, por lo que una imagen que haya quedado conectada en una plantilla reutilizada puede cambiar la operación que creías estar haciendo. Implementación de generación y edición.
Flare y Sunburst admiten ambos tipos de trabajo. OpenAI orienta Flare hacia la rapidez y Sunburst hacia la precisión de edición; no significa que uno solo pueda generar y el otro solo editar. Para elegir por el resultado que necesitas conservar, consulta la comparación de Flare y Sunburst, junto con las fichas actuales de Flare y Sunburst.
Editar con referencias y delimitar una zona con máscara
El nodo admite hasta 16 imágenes de referencia, pero la máscara opcional exige exactamente una imagen. Son dos situaciones diferentes: varias referencias pueden orientar una composición; una máscara delimita la zona de edición de una única imagen. No conectes una máscara a un conjunto de referencias esperando que el nodo deduzca a cuál corresponde. Límites en el código oficial.
Para cambiar el fondo de una fotografía de producto, carga una sola imagen, conecta su salida al nodo y utiliza una máscara que seleccione el fondo. En ComfyUI, el blanco marca la zona que se quiere editar. Explica también el cambio en el texto: «Sustituye el fondo por una pared de yeso claro; conserva la mochila, las correas y su posición».
Si vienes de ejemplos de Images API, puede parecer que la convención está invertida: la API emplea transparencia para indicar la región editable. El nodo de ComfyUI transforma la máscara antes de enviarla, calculando el alfa como 1 - mask. Trabaja con la convención de ComfyUI al pintar; no inviertas la máscara por haber leído un ejemplo de carga directa a la API.
Una máscara expresa dónde intervenir, pero no garantiza que los demás píxeles queden idénticos. Revisa bordes, texto, logotipos y proporciones antes de dar por válida una edición. Además, la implementación reduce las referencias hasta un máximo de 4 194 304 píxeles en total, equivalente a una imagen de 2048 × 2048 antes de subirlas. Una referencia enorme no llega necesariamente al servicio con todos sus píxeles originales.
Tamaño, calidad y semilla: qué controlan realmente
Para empezar, un tamaño predefinido evita errores entre límites que deben cumplirse a la vez. En el modo personalizado, no basta con que el campo acepte escribir un número.
| Ajuste | Condiciones de la implementación consultada |
|---|---|
| Anchura y altura personalizadas | Múltiplos de 16; la interfaz parte de un mínimo de 480 píxeles por lado |
| Lado más largo | Como máximo 3840 píxeles |
| Relación de aspecto | No superar 3:1 entre lado largo y corto |
| Superficie total | Entre 655 360 y 8 294 400 píxeles |
| Calidad del nodo | low, medium, high, xhigh, max |
Número de imágenes, n | De 1 a 8 |
Semilla, seed | El servicio no la implementa como control reproducible |
Por ejemplo, 3840 × 2160 suma 8 294 400 píxeles y figura entre los tamaños predefinidos. 3840 × 3840 suma 14 745 600 y supera el máximo, aunque cada lado por separado no lo supere. 480 × 480 tampoco pasa: queda por debajo de la superficie mínima. Los límites proceden del validador del nodo, no de una prueba nuestra de todos esos tamaños.
La API directa de OpenAI también documenta auto para calidad, pero la lista de calidad del nodo consultado no lo incluye. Copia valores compatibles con el lugar donde los introduces; no traslades todas las opciones de la API a los menús de ComfyUI.
Aunque veas un control de semilla, repetir su valor no garantiza la misma imagen. Para comparar configuraciones, guarda el texto, las referencias, la máscara y los ajustes de cada ejecución, junto al archivo producido. Esa trazabilidad permite revisar cambios; una supuesta semilla determinista no.
Si falta el nodo o la ejecución se detiene
Nodo desconocido al abrir el JSON. Revisa que tu instalación contenga OpenAIGPTImageNodeV2 y que el flujo no dependa de un nodo comunitario distinto. Actualiza desde el mecanismo de tu distribución y consulta la plantilla oficial correspondiente. Descargar un checkpoint no resuelve la ausencia de un Partner Node.
Fallo de autenticación o saldo. Comprueba la sesión y los créditos en Comfy; si trabajas desde otra máquina de la red, revisa la configuración de ComfyUI Account API Key. Cambiar el texto del encargo no corrige una cuenta sin saldo.
Rechazo al añadir máscara o dimensiones. Aísla el ajuste: una sola referencia con máscara, o un tamaño predefinido en lugar de uno personalizado. Así podrás distinguir un problema del archivo de una combinación no admitida.
Hay una imagen en la vista previa, pero no encuentras la entrega. Verifica que Save Image esté conectado y que el archivo esperado exista en la salida de tu instalación. Si después lo envías a otra aplicación, ese envío necesita su propia confirmación.
¿Puedo lanzar este flujo desde n8n?
ComfyUI puede formar parte de una automatización externa, pero un tutorial antiguo que exporta un flujo de SDXL o Flux no demuestra que gestione la autenticación de este Partner Node. Antes de programar ejecuciones, comprueba cómo pasa la identidad Comfy, cómo detecta la finalización y cómo recupera el archivo. Una espera fija entre nodos no acredita que la imagen esté lista.
¿Hay que instalar una extensión para usar otra clave de API?
El nodo oficial descrito aquí usa cuenta y créditos de Comfy. Si necesitas facturación directa de OpenAI o un servicio compatible, tendrás que evaluar una integración distinta que documente URL, autenticación y modelos admitidos. No confundas esa decisión con un paso obligatorio para instalar GPT Image 2.5 en ComfyUI: el soporte oficial ya tiene su propio nodo y sus plantillas.
