Skip to main content
Comfy API permite que tu aplicación ejecute flujos de trabajo de ComfyUI a través de un endpoint gestionado. Empaquetas la versión de ComfyUI, los modelos, los nodos personalizados y las dependencias que necesita el flujo de trabajo, y luego Comfy lo ejecuta en GPUs gestionadas. Úsalo cuando necesites un entorno repetible y un endpoint al que tu aplicación pueda llamar.

​
Conceptos de la plataforma

Los flujos de trabajo compatibles con Comfy Cloud pueden ejecutarse allí sin crear un Build ni un despliegue.

Inicio rápido de la API de Comfy

Comienza con un agente o elige otra forma de proporcionar tu entorno o flujo de trabajo.
Para las instantáneas de Desktop y las importaciones de flujos de trabajo en JSON, consulta Orígenes de Build.

​
El archivo Build

comfy-build.yaml guarda la definición del Build y el último estado remoto conocido. La CLI usa ese estado para detectar cuándo ha cambiado el Build remoto. Mantén el archivo junto al proyecto. Describe el entorno, pero no contiene archivos de modelos. Comprueba cómo se compara el Build local con la instalación y con la versión remota antes de publicar cambios:

​
Actualizar y publicar

Después de cambiar la instalación local, actualiza la definición del Build:
Para crear otra versión a partir de un Build existente, consulta los destinos admitidos y selecciona uno:
Sigue el registro de compilación de una versión con:

​
Regiones y disponibilidad de GPU

La capacidad de las regiones cambia, así que consulta el catálogo de la plataforma al elegir un objetivo de implementación. Filtra los resultados con --region <region>:
El catálogo es la fuente de verdad sobre qué clases de GPU están disponibles en cada región al momento de la implementación.

​
Límites del espacio de trabajo

Consulta Limits para ver el uso y los límites de tu plan de tu espacio de trabajo. Mantén --max dentro del límite de workers por despliegue.

​
Supervisar y llamar a un despliegue

Las opciones --min y --max establecen los límites de workers. Ejecuta comfy deploy status --watch para seguir el estado del despliegue, la vigencia de las versiones y la actividad de servicio. También puedes llamar al endpoint con los SDK de Comfy. Establece COMFY_BASE_URL en la URL del despliegue y proporciona una clave API. Consulta Elegir una URL base.

​
Operar un despliegue

​
Inspeccionar y limpiar

Eliminar un despliegue y eliminar un Build son operaciones irreversibles e independientes. Confirma el objetivo antes de usar comfy deploy delete --yes o comfy build delete --id bld_123456 --yes.

​
Preguntas frecuentes

Sí. En el Builder, sube uno o más flujos de trabajo para preseleccionar sus modelos y nodos personalizados. Incluye las dependencias que necesitan todos los flujos de trabajo que planeas ejecutar y luego envía cada flujo de trabajo en formato API al endpoint desplegado.Cada despliegue usa un solo tipo de GPU. Para ejecutar flujos de trabajo en distintos tipos de GPU, crea despliegues separados del mismo Build.
No. Los Builds y sus releases se guardan en tu cuenta sin costo. No se te factura el espacio de almacenamiento de un Build hasta que lo despliegas.La facturación de almacenamiento comienza con un despliegue:
  • Cuando despliegas un release, sus modelos se preparan en almacenamiento de red compartido por los workers del despliegue. El almacenamiento es de solo lectura después del despliegue y se factura por GB-mes mientras exista cualquier despliegue del Build en esa región, incluso mientras un despliegue está en pausa con comfy deploy stop.
  • Cada worker también recibe un disco de contenedor fijo de 50 GB. Es efímero y solo se factura mientras el worker está en ejecución, como parte del costo de cómputo del worker.
  • Eliminar un despliegue libera su cómputo. El almacenamiento de red preparado se limpia poco después de que se elimine el último despliegue que lo usa en esa región, y su facturación termina.
Para conocer las tarifas de almacenamiento vigentes, consulta la página de precios de Comfy. El catálogo de cómputo (comfy deploy refs compute) y el diálogo de despliegue también muestran las tarifas que aplican a un despliegue.
--min define la cantidad de workers activos: workers que permanecen en ejecución todo el tiempo para que las solicitudes nunca esperen un inicio en frío. Un worker activo se factura por segundo durante todo el tiempo que está en ejecución, procese tareas o no.Los workers por encima de --min, hasta --max, son workers flexibles. Un worker flexible se factura por segundo desde el momento en que inicia (incluido el arranque y la carga de modelos), durante el procesamiento de tareas, más una breve ventana de inactividad (actualmente 30 segundos) antes de reducirse. Cuando los workers flexibles se reducen, no cuestan nada. Con --min 0, todo el despliegue se reduce a cero y no factura cómputo mientras está inactivo, a cambio de un inicio en frío en la primera solicitud.La facturación mide el uso real por segundo de los workers, multiplicado por la cantidad de workers en ejecución. Si tu espacio de trabajo se queda sin créditos, los despliegues se detienen automáticamente.Para conocer las tarifas vigentes por worker de GPU, consulta la página de precios de Comfy. Las tarifas se expresan por hora de worker y se facturan por segundo. La disponibilidad de GPU por región proviene del catálogo de cómputo: ejecuta comfy deploy refs compute para ver la lista actual.
Un despliegue distribuye automáticamente las solicitudes entre sus workers y escala dentro de los límites configurados de --min y --max. Las solicitudes que no pueden ejecutarse de inmediato quedan en cola y se procesan a medida que haya capacidad de workers disponible.
Sigue el estado del despliegue y luego revisa sus registros y eventos para encontrar la causa:
Si la GPU o la región seleccionada no tiene capacidad, reintenta más tarde o ejecuta comfy deploy refs compute y elige un par de región y GPU disponible. Incluye los ID del Build, del release y del despliegue cuando pidas ayuda.
Eliminar un despliegue quita su endpoint y libera su cómputo. No elimina el Build ni sus releases. Después de que elimines el último despliegue que usa ese Build en una región, el almacenamiento de red preparado se limpia y la facturación de almacenamiento termina poco después.Eliminar el Build es una operación aparte: comfy build delete --id <build-id> --yes.

​
Próximos pasos

SDKs de Comfy

Úsalos desde una aplicación de Python o TypeScript para enviar flujos de trabajo y gestionar entradas, progreso y salidas.

Comfy API v2

Úsala desde cualquier lenguaje cuando llames directamente a la API HTTP o quieras consultar sus formatos de solicitud y respuesta.

Formato de API de flujo de trabajo

Úsalo cuando prepares un JSON de flujo de trabajo para una solicitud a la API o para solucionar problemas con sus entradas y salidas.

Referencia de Comfy CLI

Úsala para automatizar los comandos de compilación, publicación, despliegue y flujos de trabajo desde una terminal.