Saltar al contenido principal
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 de Build

comfy-build.yaml almacena 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 modelo. Comprueba cómo se compara el Build local con la instalación y la versión remota antes de subir cambios:

Actualizar y publicar una versión

Después de cambiar la instalación local, actualiza la definición de Build:
Para crear otra versión a partir de un Build existente, consulta los objetivos admitidos y elige 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 cuando elijas un objetivo de despliegue. Filtra los resultados con --region <region>:
El catálogo es la fuente de referencia sobre qué clases de GPU están disponibles en cada región en el momento del despliegue.

Límites del espacio de trabajo

Consulta Limits para ver el uso y los límites de tu plan de 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 Comfy SDKs. Establece COMFY_BASE_URL con 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 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 después 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 cargo. 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 el almacenamiento en red que comparten los workers del despliegue. Ese 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 en red preparado se limpia poco después de eliminar el último despliegue que lo usa en esa región, y la facturación correspondiente termina.
Para conocer las tarifas de almacenamiento actuales, 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 se aplican a un despliegue.
--min establece el número de workers activos: workers que permanecen en ejecución en todo momento 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 o no tareas.Los workers por encima de --min, hasta --max, son workers flexibles. Un worker flexible se factura por segundo desde el momento en que arranca (incluidos el arranque y la carga de modelos), durante todo 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 el número 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 actuales de GPU por worker, 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 se ponen en cola y se procesan a medida que hay capacidad de workers disponible.
Sigue el estado del despliegue y después 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 IDs 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 eliminar el último despliegue que usa ese Build en una región, su almacenamiento en 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

Comfy SDKs

Ú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 cuando revises sus formatos de solicitud y respuesta.

Workflow API Format

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

Comfy CLI Reference

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