Skip to main content
Obsoleto: La API de Cloud v1 está obsoleta en favor de Comfy API v2. Sigue disponible para las integraciones existentes y para las capacidades de Cloud que v2 aún no expone, pero los endpoints y el comportamiento pueden cambiar sin previo aviso.
La API de Cloud v1 proporciona acceso programático a Comfy Cloud, el servicio administrado de Comfy para ejecutar flujos de trabajo en infraestructura en la nube. Comfy Cloud es una aplicación con estado. Tu cuenta mantiene un estado que persiste entre tareas: créditos y nivel de suscripción, recursos subidos y salidas generadas, la cola de trabajos y el conjunto de modelos y nodos instalados. La API v1 abarca toda esa aplicación, así que incluye funcionalidad que la portable Comfy API v2 no admite, como la gestión de la cola, la exploración de modelos, las definiciones de nodos y los endpoints de cuenta. Usa v2 (o los SDK que la envuelven) para enviar flujos de trabajo y obtener resultados de una forma que también funcione con despliegues de Comfy API y con ComfyUI autoalojado. Usa v1 para las capacidades específicas de Cloud a su alrededor. Para ejecutar flujos de trabajo, empieza con la Guía de inicio rápido de Comfy Cloud y los SDK de Comfy. Los créditos y los límites de concurrencia se tratan en Uso y límites; los ejemplos ejecutables de v1 están en la Referencia de la API de Cloud. Esta página cubre la superficie específica de v1: la autenticación y los endpoints que v2 no expone.
Suscripción requerida: El acceso a la API requiere una suscripción de pago a Comfy Cloud; el nivel Gratis no lo incluye. Consulta los planes de precios.

​
URL base

​
Autenticación

Todas las solicitudes v1 requieren una clave API enviada en el encabezado X-API-Key:
Consulta Obtener una clave API para ver las instrucciones sobre cómo crear y administrar claves. Una clave inválida o faltante devuelve 401. Una clave con una suscripción inactiva devuelve 429. La misma clave se usa para los Nodos asociados. Por HTTP, la vuelves a pasar en extra_data.api_key_comfy_org; consulta Usar Nodos asociados para ver ejemplos.

​
Lo que los SDK aún no cubren

Los SDK cubren cómo ejecutar un flujo de trabajo, obtener los resultados y cancelar una tarea. El resto de la superficie de Cloud solo está disponible por HTTP, así que llama directamente a estos endpoints aunque uses un SDK para la ejecución. Cancelar una tarea lo cubren ambos: los SDK cancelan una tarea de la que tienes un identificador, y POST /api/queue cancela por ID.

​
Endpoints disponibles

​
Manejo de errores

Los endpoints REST devuelven códigos de estado HTTP estándar: En su lugar, los SDK lanzan estas situaciones como excepciones tipadas, incluidas Unauthorized, InvalidWorkflow, InsufficientCredits, QueueFull y JobFailed, todas las cuales extienden ComfyError. Las fallas de ejecución son independientes de los errores HTTP. Consulta Manejo de errores para conocer los valores de exception_type que se entregan durante la ejecución.

​
Próximos pasos

Comfy Cloud Quickstart

Ejecuta un flujo de trabajo desde Python o TypeScript.

Uso y límites

Revisa los créditos de Cloud, la concurrencia y las integraciones v1 existentes.

Referencia de la API de Cloud

Documentación completa de los endpoints con ejemplos en curl, Python y TypeScript.

Referencia de Comfy API v2

La API HTTP versionada que sustenta ambos SDK. Úsala desde cualquier idioma.

Especificación OpenAPI

Especificación de API legible por máquina para generar código.