Saltar al contenido principal
Obsoleto: La API v1 de Cloud 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 v1 de Cloud 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 es la interfaz de toda esa aplicación, así que incluye funcionalidad que la versión portátil de 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 que la rodean. 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 lo específico 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 a la 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. Esta clave también se usa para los Nodos asociados. Por HTTP la vuelves a pasar en extra_data.api_key_comfy_org; consulta Uso de los Nodos asociados para ver ejemplos.

Lo que los SDK aún no cubren

Los SDK cubren la ejecución de un flujo de trabajo, la obtención de los resultados y la cancelación de una tarea. Al resto de la superficie de Cloud solo se llega por HTTP, así que llama a estos endpoints directamente incluso si usas un SDK para la ejecución. Cancelar una tarea está cubierto por ambos: los SDK cancelan una tarea sobre la que tienes un handle, 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 estos casos como excepciones tipadas, entre ellas Unauthorized, InvalidWorkflow, InsufficientCredits, QueueFull y JobFailed, todas heredando de ComfyError. Las fallas de ejecución son independientes de los errores HTTP. Consulta Manejo de errores para ver los valores de exception_type que se entregan durante la ejecución.

Próximos pasos

Inicio rápido de Comfy Cloud

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 hay debajo de ambos SDK. Úsala desde cualquier idioma.

Especificación de OpenAPI

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