> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# ComfyUI
> Use la generación de imágenes de EvoLink (texto a imagen / imagen a imagen) dentro de ComfyUI — sin necesidad de GPU local
## Descripción general
[ComfyUI](https://www.comfy.org/) es la herramienta **de código abierto basada en nodos** más popular para la generación de imágenes con IA: cada paso — cargar un modelo, escribir un prompt, generar una imagen — se convierte en un nodo que usted conecta sobre un lienzo, como si armara bloques, para construir flujos de trabajo altamente flexibles y reutilizables. Gratuita, de código abierto y respaldada por un enorme ecosistema de plugins, se ha convertido en la mesa de trabajo de referencia para la creación visual con IA.
Con el **plugin oficial de EvoLink para ComfyUI**, puede llamar al modelo en la nube `gpt-image-2` directamente desde sus flujos de trabajo de ComfyUI — tanto texto a imagen como imagen a imagen, **sin necesidad de GPU local**.
**Compatible con**: ComfyUI Desktop, versiones portátiles, instalaciones manuales y el paquete todo-en-uno chino "aki" (ComfyUI-aki).
## Antes de comenzar
### Obtenga una API Key de EvoLink
1. Inicie sesión en el [panel de EvoLink](https://evolink.ai/dashboard)
2. Abra la [página de API Keys](https://evolink.ai/dashboard/keys), cree una clave y cópiela (comienza con `sk-`)
**Su API Key es la llave del saldo de su cuenta.** Guárdela únicamente en la configuración local del nodo — nunca la pegue en chats, capturas de pantalla ni repositorios públicos. Si sospecha una filtración, elimínela y vuelva a crearla de inmediato.
### Confirme que tiene créditos
La generación consume créditos. Verifique su saldo en el [panel](https://evolink.ai/dashboard); el consumo de cada tarea aparece en el [registro de tareas](https://evolink.ai/dashboard/logs).
## Paso 1: Instalar el plugin oficial
1. Abra ComfyUI Desktop → haga clic en **Manager** en la barra de herramientas superior para abrir el gestor de nodos
2. Busque **`evolink`** → elija la entrada **EvoLink** cuyo Created By sea **evolink** → haga clic en **Install**
3. Reinicie ComfyUI cuando se le indique
Publicado en el Registry oficial de ComfyUI ([registry.comfy.org/nodes/evolink-nodes](https://registry.comfy.org/nodes/evolink-nodes)) — se puede buscar desde el Manager en Desktop, versiones de navegador y distribuciones empaquetadas.
1. Inicie ComfyUI desde el lanzador y, en el navegador, haga clic en **Manager** en la barra de herramientas superior → **Custom Nodes Manager**
2. Escriba **`evolink`** en el cuadro de búsqueda → elija la entrada **EvoLink** cuyo Author sea **evolink** → haga clic en **Install**
3. Cuando la columna Action muestre **Restart Required**, la instalación se completó → termine el proceso y vuelva a iniciar desde el lanzador → **actualice el navegador**
Si durante la instalación aparece el error `Neither 'pip' nor 'uv' are available for package management`, **puede ignorarlo**: la única dependencia de este plugin es `requests`, que el paquete ya incluye. Mientras la columna Action muestre **Restart Required**, la instalación fue exitosa.
Dentro de `ComfyUI/custom_nodes`, ejecute:
```bash theme={null}
git clone https://github.com/deeplearning-goethe/comfyui-evolink.git
```
Usuarios del paquete todo-en-uno aki: `custom_nodes` está dentro de su carpeta de instalación `ComfyUI-aki-vX.X`; ejecute el comando desde el terminal del lanzador o abra PowerShell en ese directorio.
1. Abra el [repositorio del plugin](https://github.com/deeplearning-goethe/comfyui-evolink) → botón verde **Code** → **Download ZIP**, descomprima
2. Mueva la carpeta a `ComfyUI/custom_nodes/`
3. **Comprobación de anidamiento (imprescindible)**: al abrir `custom_nodes/comfyui-evolink/` debería ver `__init__.py` directamente. Si ve otra carpeta interior con el mismo nombre (problema habitual al descomprimir), mueva la carpeta interior hacia arriba y elimine el cascarón vacío.
Un diseño correcto se ve así:
```
ComfyUI-aki-v3.7\
└─ custom_nodes\
├─ ComfyUI-Manager\
└─ comfyui-evolink\
├─ __init__.py
└─ ...otros archivos
```
La única dependencia es `requests` (normalmente ya incluida con ComfyUI).
Esto ocurre porque las versiones del plugin están pasando la revisión de seguridad del registro oficial de ComfyUI (un proceso habitual para nodos de API en la nube), y el nivel de seguridad predeterminado del Manager bloquea la instalación mientras tanto. Puede **bajar temporalmente el nivel de seguridad del Manager** — y restaurarlo después:
**Paso 1: Cierre ComfyUI por completo**
* Paquete todo-en-uno aki: lanzador → **Terminar proceso**
* Desktop oficial / portátil / instalación manual: salga completamente de la aplicación, incluida la ventana de consola
**Paso 2: Edite el archivo de configuración del Manager `config.ini`**
Localícelo según su tipo de instalación (o simplemente busque `config.ini` dentro de su carpeta de ComfyUI y elija el que tenga `manager` en la ruta):
| Entorno | Ubicación de config.ini |
| --------------------------------------------- | ----------------------------------------------------------------------------------------- |
| Paquete todo-en-uno aki | `su-ruta-de-descarga\ComfyUI-aki-vX.X\ComfyUI-aki-vX.X\ComfyUI\user\__manager\config.ini` |
| Versión oficial (Desktop / portátil / manual) | `directorio de instalación de ComfyUI\user\default\ComfyUI-Manager\config.ini` |
Ábralo con el Bloc de notas, localice la línea `security_level` y cambie `normal` por `weak`:
```ini theme={null}
security_level = weak
```
Guarde y cierre.
**Paso 3: Reinicie ComfyUI e instale de nuevo**
Inicie ComfyUI → Manager → busque `evolink` → **Install**. Ignore el mensaje `Neither 'pip' nor 'uv'...` si aparece. Cuando vea **Restart Required**, reinicie por completo una vez más y actualice el navegador.
**Paso 4: Verifique y restaure el nivel de seguridad**
* Confirme que los nodos cargan según [Verificar la instalación](#verificar-la-instalación) más abajo
* ⚠️ **Vuelva a cambiar `security_level` a `normal` después de instalar** (repita los pasos 1–2) para restaurar la protección predeterminada del Manager
### Verificar la instalación
Tras un reinicio completo y una actualización del navegador, **haga doble clic** en el lienzo vacío → busque `evolink`. Si ve los dos nodos **EvoLink GPT Image 2 (Official)** y **EvoLink Upload Image (Official)**, la instalación fue exitosa:
¿No aparecen los nodos? Asegúrese de haber hecho un **reinicio completo** (no solo actualizar el navegador); si persiste, consulte las [preguntas frecuentes](#preguntas-frecuentes).
## Paso 2: Su primera imagen (texto a imagen, 5 minutos)
1. **Haga doble clic** en el lienzo vacío (o clic derecho → Add Node) → busque **`EvoLink`** → añada **EvoLink GPT Image 2 (Official)**
2. Complete los campos:
* `api_key`: pegue su clave `sk-`. **Solo la primera vez** — tras la primera ejecución se guarda en un archivo de configuración local; después deje el campo vacío (y límpielo antes de compartir flujos de trabajo)
* `prompt`: su descripción (puede escribirla en español), p. ej. `un shiba inu con una bufanda roja sentado en la nieve, ilustración plana`
* Mantenga los demás valores predeterminados (`quality=low` es lo más barato para pruebas)
3. **Conecte un nodo de visualización (imprescindible)**: arrastre desde el punto de salida `image` hasta el lienzo vacío y elija **Preview Image**; añada también un nodo **Save Image** si quiere que los archivos se escriban en la carpeta `output` de ComfyUI
**El error más común de los principiantes**: el nodo EvoLink genera pero no muestra. Si la salida `image` no está conectada a nada, la tarea termina y usted no ve ninguna imagen.
4. Pulse **Queue Prompt**. El nodo envía la tarea, consulta el progreso con una barra en tiempo real y recupera el resultado, que se muestra directamente en el nodo Preview.
## Paso 3: Imagen a imagen (3 pasos)
1. Añada un nodo **Load Image** y elija su imagen local
2. Conecte su salida de imagen a la entrada **`image1`** del nodo EvoLink
3. Describa la modificación en `prompt` → ejecute
Su imagen se sube automáticamente a través del **canal oficial de archivos de EvoLink** para obtener una URL temporal (**se elimina automáticamente a las 72 horas**) — sin pasar por ningún alojamiento de imágenes de terceros ni registrarse en servicios adicionales.
**Uso avanzado**:
* **Múltiples imágenes de referencia**: las entradas `image1`–`image4` más el cuadro de texto `image_urls` (una URL pública por línea) pueden combinarse — hasta **16 imágenes** en total
* **Flujos de trabajo complejos**: el nodo incluido **EvoLink Upload Image (Official)** convierte imágenes locales en texto de URL (no es necesario para imagen a imagen normal)
* **Flujos de trabajo listos para usar**: [example\_workflows](https://github.com/deeplearning-goethe/comfyui-evolink/tree/main/example_workflows) incluye ejemplos de texto a imagen / imagen a imagen / referencias múltiples. **El PNG de resultado de cada ejemplo lleva incrustado el flujo de trabajo completo — descargue la imagen y arrástrela al lienzo para restaurar todos los nodos y conexiones** (capacidad nativa de ComfyUI); también se incluyen los archivos JSON correspondientes
## Parámetros
| Parámetro | Descripción |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `prompt` | Descripción / instrucción de edición, admite varios idiomas (español incluido), hasta 32.000 caracteres |
| `model` | `gpt-image-2` (predeterminado) / `gpt-image-2-beta` |
| `size` | `auto` (predeterminado, el modelo decide la composición) / proporción como `1:1`, `16:9` / píxeles como `1024x1024` |
| `resolution` | `1K` / `2K` / `4K`, se aplica cuando size es una proporción o auto |
| `quality` | `low` / `medium` / `high` — **cuanto más alta, más cara**; use `low` para pruebas |
| `n` | Imágenes por ejecución (1–10) |
| `api_key` | Se guarda localmente en el primer uso, después déjela vacía; también funciona la variable de entorno `EVOLINK_API_KEY` |
| `image1`–`image4` | Entradas de imágenes de referencia — conecte Load Image para imagen a imagen |
| `image_urls` | Avanzado: una URL pública por línea |
| `timeout_seconds` | Espera máxima (300 s por defecto); las tareas que agotan el tiempo no se cobran |
Salidas: `image` (resultado, ya descargado), `task_id` (para consultas de facturación y soporte), `status_info` (resumen de la ejecución: tiempo, créditos consumidos, etc.).
## Facturación y verificación
* **Pago por uso, sin suscripción**: los créditos se reservan al enviar la tarea (`credits_reserved`) y se liquidan al completarse
* **Las tareas fallidas o con tiempo agotado no se cobran** — los créditos se devuelven automáticamente
* **La caché no consume créditos**: repetir la ejecución sin cambiar parámetros reutiliza la caché local de ComfyUI, sin lanzar una nueva solicitud
* **Cada tarea es auditable**: consulte cualquier `task_id` en el [registro de tareas](https://evolink.ai/dashboard/logs); si tiene dudas sobre un cargo, envíe el `task_id` a soporte para su verificación
## Preguntas frecuentes
Compruebe en orden: ① la carpeta del plugin está directamente bajo `custom_nodes`; ② no hay carpetas anidadas duplicadas por la descompresión (`__init__.py` debe verse al abrir la carpeta); ③ reinició ComfyUI por completo (ventana de consola cerrada, no solo el navegador); ④ busque `evolink` en el registro de arranque — capture cualquier error en rojo para soporte. Los usuarios del paquete todo-en-uno aki también pueden ejecutar un diagnóstico del entorno con un clic desde el panel de solución de problemas del lanzador.
Las versiones del plugin están pasando la revisión de seguridad del registro oficial de ComfyUI, y el nivel de seguridad predeterminado del Manager bloquea temporalmente la instalación. Consulte la solución desplegable en la [sección de instalación](#paso-1-instalar-el-plugin-oficial): cambie temporalmente el `security_level` del Manager a `weak`, instale y vuelva a ponerlo en `normal` — o use directamente la opción C (git) / opción D (ZIP); el plugin funciona exactamente igual.
Puede ignorarlo. El Manager simplemente no encontró un gestor de paquetes para instalar dependencias; la única dependencia de este plugin es `requests`, que ComfyUI ya incluye. Si la lista muestra **Restart Required**, reinicie y los nodos cargarán sin problemas.
La salida `image` no está conectada a un nodo Preview Image / Save Image. Conéctela y ejecute de nuevo — el resultado en caché se muestra al instante sin cargo adicional.
Es normal cuando solo hay conectado un nodo **Preview Image** (las vistas previas no se escriben en disco). Para que las imágenes aparezcan en el panel y en la carpeta `output`, use un nodo **Save Image**.
Clave incorrecta, espacios de más o la clave fue eliminada. Verifíquela en la [página de API Keys](https://evolink.ai/dashboard/keys); tras recrearla, rellene una vez el campo `api_key` del nodo para sobrescribir la clave antigua guardada localmente.
No hay créditos suficientes — recargue en el [panel](https://evolink.ai/dashboard) y reintente.
Alcanzó el límite de frecuencia — espere un momento y ejecute de nuevo.
El prompt o una imagen de referencia activó la moderación de la plataforma. Ajuste y reintente — **las tareas fallidas no se cobran**.
Las URL de los resultados expiran a las **24 horas** y las referencias subidas a las **72 horas** — pero el nodo ya descarga los resultados dentro del flujo de trabajo; use un nodo **Save Image** para conservarlos permanentemente en la carpeta local `output`.
Las tareas de alta resolución / alta calidad / muchas imágenes (n grande) tardan más; el nodo espera hasta 300 s por defecto (ajustable con `timeout_seconds`). Los tiempos agotados **no se cobran** — verifique el estado final de la tarea en el [registro de tareas](https://evolink.ai/dashboard/logs).
**Nodos oficiales antiguos** (con entradas de imagen): uso idéntico — Load Image → `image1`. **Comunidad `ComfyUI_EvoLink`**: los nombres de parámetros coinciden; su nodo `Evolink Image Input` basado en imgbb ya no es necesario (conecte las imágenes directamente a `image1`); `poll_interval`/`max_polls` se unificaron en `timeout_seconds`. Ambos plugins pueden coexistir, no hace falta desinstalar primero.
Primero asegúrese de que el registro de la consola muestre `To see the GUI go to` (el primer arranque es lento); si sigue sin abrir, pruebe `http://localhost:8188`, o compruebe si un proxy del sistema / VPN está interceptando las direcciones locales (añada `127.0.0.1` a la lista de exclusiones del proxy). Si usa un proxy, configure `api.evolink.ai` y `files-api.evolink.ai` para conexión directa.
El plugin cubre actualmente la serie `gpt-image-2`. Nano Banana (serie Gemini), Seedream y los modelos de video (Veo / Sora / Kling) están en la hoja de ruta; mientras tanto, todos los modelos del [catálogo completo](https://evolink.ai/models) pueden llamarse mediante la [API directa](#apéndice-llamar-a-la-api-sin-el-plugin).
¿Sigue con problemas? Envíe el **ID de la tarea / captura del registro de arranque / texto exacto del error** a [support@evolink.ai](mailto:support@evolink.ai).
## Apéndice: llamar a la API sin el plugin
Útil para verificar una clave, o para modelos que el plugin aún no cubre.
**Verifique su clave en 30 segundos (gratis):**
```bash theme={null}
curl -s -H "Authorization: Bearer sk-TU_CLAVE" https://api.evolink.ai/v1/models
```
Una lista de modelos (`{"data":[{"id":...`) significa que la clave funciona; `Unauthorized` significa que no.
**Envíe una tarea de generación:**
```bash theme={null}
curl -s -X POST https://api.evolink.ai/v1/images/generations \
-H "Authorization: Bearer sk-TU_CLAVE" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2","prompt":"a cute cat, watercolor style","size":"1:1","resolution":"1K","quality":"low","n":1}'
```
Anote el `id` de la tarea devuelto (comienza con `task-unified-`) y consulte hasta que `status` sea `completed`; el arreglo `results` contiene las URL de las imágenes (descárguelas dentro de las 24 horas):
```bash theme={null}
curl -s -H "Authorization: Bearer sk-TU_CLAVE" https://api.evolink.ai/v1/tasks/TASK_ID
```
Referencia completa de la API: [Generación de imágenes](https://evolink.ai/docs/es/api-manual/image-series/gpt-image-2/gpt-image-2-image-generation) | [Consulta de tareas](https://evolink.ai/docs/es/api-manual/task-management/get-task-detail) | [Subida de archivos](https://evolink.ai/docs/es/api-manual/file-series/upload-base64)