Nodos de ComfyUI

El paquete de nodos de SpicyAPI para ComfyUI convierte cada modelo de imagen, video y audio de SpicyAPI en un nodo de ComfyUI: más de 180, además de un nodo SpicyAPI Chat para los modelos de texto y un nodo SpicyAPI LoRA. Los modelos se ejecutan en los servidores de SpicyAPI, así que necesitas conexión a internet y una clave de API, no una tarjeta gráfica ni pesos descargados. Cada nodo muestra su precio antes de ejecutarse e imprime lo que costó la ejecución cuando termina.

El paquete es gratuito y de código abierto (MIT) en github.com/spicyapi-ai/comfyui-spicyapi. No instala nada aparte del propio ComfyUI.

¿Es la herramienta adecuada?

Todas comparten la misma cuenta, el mismo saldo, los mismos modelos y los mismos precios.

Antes de empezar

• Un ComfyUI reciente. Los nodos usan la API de nodos V3 de ComfyUI y se probaron con ComfyUI 0.39. Sirve cualquier instalación que cargue carpetas desde custom_nodes: la aplicación de escritorio, la versión portable o una instalación manual.
• Una clave de API. Crea una en la consola; empieza por sk-spicy-. Si aún no tienes cuenta, consulta Configura tu cuenta.
• Saldo. Cada ejecución se paga con tu saldo prepago en USD. Consulta Facturación.
• Acceso a api.spicyapi.ai desde el equipo que ejecuta ComfyUI. Se respeta un proxy definido con HTTPS_PROXY.

Instalación

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Añade tu clave de API

Abre Settings > SpicyAPI > API key y pega tu clave. Un aviso confirma que la clave funciona y muestra tu saldo disponible. Después reinicia ComfyUI una vez: la lista de nodos se construye con el catálogo en vivo de tu cuenta cuando ComfyUI arranca, y mientras no haya una clave se usa la lista incluida en la versión.

La clave se guarda en un archivo de la carpeta de usuario de ComfyUI (user/spicyapi/config.json) que solo puede leer tu cuenta. Nunca se escribe en un archivo de flujo de trabajo ni en los metadatos de una imagen que guarda ComfyUI, así que compartir cualquiera de los dos no comparte tu clave. Después, el campo de ajustes solo muestra los últimos cuatro caracteres. Para quitar la clave, vacía el campo.

En un servidor o en un contenedor, define en su lugar la variable de entorno SPICY_API_KEY. Tiene prioridad sobre el campo de ajustes.

Ejecuta tu primer nodo

¿Prefieres partir de un grafo que ya funciona? El explorador de plantillas de ComfyUI muestra los ejemplos del paquete bajo comfyui-spicyapi: texto a imagen, imagen a video, un modelo de chat que escribe el prompt para un modelo de imagen, texto a voz y LoRA.

Puedes ver ejemplos completos con sus resultados, precios y tiempos de ejecución reales, además de la lista en vivo de nodos sin censura, en la página de ComfyUI de spicyapi.ai.

Cómo funcionan los nodos

Cada nodo se genera a partir del esquema de entrada publicado de su modelo, el mismo con el que la API valida las solicitudes, así que un nodo nunca ofrece una opción que el modelo rechazaría.

Un menú desplegable en model default, o un número en -1, se omite de la solicitud para que el modelo use su propio valor predeterminado.

Las salidas son valores normales de ComfyUI, así que cualquier otro nodo puede recibirlas:

• Los modelos de imagen devuelven IMAGE. La eliminación de fondo devuelve además una máscara alpha.
• Los modelos de video devuelven VIDEO, más el último fotograma del clip como IMAGE cuando return_last_frame está activado.
• Los modelos de audio devuelven AUDIO. Un modelo que devuelve varios clips, como Suno, los devuelve como un solo lote y Save Audio escribe un archivo por cada uno.
• La transcripción devuelve STRING.
• Cada nodo devuelve además su task_id, para los registros de la consola o una consulta a soporte.

Nodos Chat y LoRA

SpicyAPI Chat envía un prompt, instrucciones de sistema opcionales e imágenes opcionales a cualquier modelo de texto de SpicyAPI y devuelve la respuesta como STRING. Conéctalo al prompt de un nodo de imagen o de video para que un modelo de lenguaje escriba o refine prompts dentro del grafo. Un modelo que no lee imágenes rechaza la entrada de imagen sin cobrar nada.

SpicyAPI LoRA añade un archivo de pesos LoRA, indicado como un enlace de descarga directa a un archivo .safetensors, con una intensidad de 0 a 4. Encadena varios para combinarlos y conecta el último a la entrada loras de un nodo de modelo LoRA (sus nombres terminan en LoRA). El enlace debe abrirse sin iniciar sesión.

Cuánto cuesta una ejecución

• La insignia de cada nodo muestra la tarifa actual del modelo para las opciones que elegiste, por ejemplo $0.0525/s para video o $0.01/image, y cambia cuando las cambias.
• Cada ejecución se cotiza antes. En Settings > SpicyAPI > Max cost per run, fija un tope en dólares estadounidenses. Una ejecución cotizada por encima se detiene antes de cobrar nada.
• El cobro final aparece en el nodo cuando la ejecución termina. Las ejecuciones fallidas no se cobran, salvo en los modelos cuya página indica que los rechazos se facturan. Consulta Facturación.
• Las semillas empiezan en fixed. Poner en cola el mismo grafo dos veces reutiliza el primer resultado en lugar de pagar otra vez. Cambia control after generate a randomize para obtener un resultado nuevo, y un cobro nuevo, en cada ejecución.
• Cancelar detiene la espera, no el trabajo. Una ejecución que cancelas en ComfyUI sigue en SpicyAPI, se cobra si termina bien y su resultado está en los registros de la consola.

Los resultados permanecen en tu consola hasta 14 días, o menos si tu cuenta los conserva durante menos tiempo. Usa los nodos Save de ComfyUI para quedarte con tu propia copia. Consulta Conservación y destrucción.

Solución de problemas

Los errores de SpicyAPI terminan con un request_id o un ID de tarea. Indícaselo a soporte y la solicitud se podrá localizar con exactitud. Los códigos de error se explican en Errores.