Exportar vs Exportar (API) en ComfyUI: ¿Qué guardar?

ComfyUI es una herramienta potente para gestionar flujos de trabajo complejos en la generación de IA. Sin embargo, cuando guardas tu proyecto, te encontrarás con opciones como «Exportar» y «Exportar (API)», lo cual puede generar confusión sobre cuál utilizar.

A continuación, desglosamos las diferencias clave entre ambos formatos para entender su propósito real.

Exportar: El Proyecto Editable

La opción de exportación estándar está diseñada específicamente para volver a abrir el flujo dentro de la interfaz gráfica de ComfyUI. Al guardar de esta manera, no solo estás preservando la lógica del algoritmo, sino que también capturas todos los detalles visuales y de diseño.

Esto incluye elementos como las posiciones exactas de los nodos en el lienzo, los grupos organizados, los colores asignados a las conexiones, notas adhesivas, los estados actuales de los widgets y la metadatos del editor. En esencia, este archivo JSON funciona como un «proyecto editable» completo que te permite retomar tu trabajo visual sin perder ningún detalle estético o de layout.

Exportar (API): La Versión Mecánica

Por otro lado, la exportación para API genera una versión significativamente diferente del mismo flujo de trabajo. Este formato es mucho más «mecánico» y se enfoca exclusivamente en lo estrictamente necesario para la ejecución automática.

A diferencia del archivo estándar, el JSON de la API elimina casi todos los elementos visuales o estéticos. Se centra únicamente en guardar los nodos funcionales, las conexiones lógicas entre ellos y los parámetros necesarios para ejecutarlos correctamente.

Este formato está pensado específicamente para integraciones externas. Es ideal para llamar a workflows desde scripts Python, sistemas de automatización, bots, o incluso para integrarlos mediante una API web que utilice el endpoint `/prompt` con colas remotas.

Implicaciones Prácticas y Estabilidad

La diferencia fundamental radica en el propósito de uso. El JSON normal es un archivo «para humanos», diseñado para la interacción dentro del editor, mientras que el JSON API está optimizado a ser «para máquinas».

Una consecuencia importante de esta distinción es la estabilidad: los exportados para API suelen ser bastante más estables para automatizar. Al eliminar las dependencias de datos visuales del editor, evitas problemas potenciales al integrar ComfyUI con sistemas externos.

Específicamente, si vas a montar un sistema donde herramientas como PHP o Python le envíen trabajos directamente a ComfyUI, lo estándar es utilizar el JSON API. Esto te permite reemplazar dinámicamente valores críticos, como prompts, seeds o rutas de archivos, antes de enviarlos al servidor de ComfyUI para su procesamiento.