Nodos y conexiones (referencia)
Aprende cómo se comunican los nodos, cómo fluyen los datos por tu flujo y cómo ejecutar y gestionar tus generaciones en Nodes.
Esta guía cubre la mecánica de construir flujos en Nodes. Si apenas empiezas, revisa primero «¿Qué es Nodes?» y «¿Cómo agrego y conecto nodos?».
Tipos de nodos
Antes de conectar nada, conviene saber qué herramientas tienes. Cada nodo hace un trabajo específico: unos traen contenido, otros escriben el prompt, otros generan algo nuevo y otros transforman lo que ya tienes. Estos son los 17, en el orden del menú:
- Imagen («Subir») — Tu foto, captura o render: el punto de partida. Conectada a un Generador, la primera imagen es la base.
- Referencia — Una imagen con su papel declarado —material, mueble, elemento, escena, estilo o render ganador— para que el Generador sepa qué tomar de ella.
- Modelo 3D — Abre tu modelo (.glb, .obj, .fbx, .dae, .kmz…) en un visor; la vista que elijas sale como imagen.
- Texto — El prompt: lo que quieres ver. Trae plantillas, estilos y las «Opciones avanzadas» de ubicación, materiales, vegetación y luz.
- Scanner de imagen — Mira una imagen y escribe un prompt de render completo; su segundo modo prepara una axonometría explotada.
- Extractor de moods — Lee la atmósfera de una foto de referencia —escena, gente, luz, encuadre— y la escribe como prompt, sin copiar su arquitectura.
- Estilo — Emite el prompt de uno de los 18 estilos de la galería.
- Assistant — Convierte tu instrucción, imágenes y notas en un prompt detallado para el Generador.
- Generador de imagen — Crea el render con el modelo que elijas y guarda el historial de resultados dentro del nodo.
- Video — Anima una imagen: la conectada es el primer fotograma y el texto describe el movimiento. El clip se trabaja en su panel.
- Lista — Agrupa varios textos o varias imágenes para que un Generador corra una vez por cada uno.
- Mejorar render — Lleva un render a fotografía hiperrealista sin cambiar el diseño.
- Iluminación — Vuelve a iluminar el mismo render a otra hora del día.
- Ángulos de cámara — Fotografía el mismo espacio desde otro punto de vista.
- Escalador de imagen — Sube la resolución a 2x o 4x y agrega detalle.
- Grupo — Un marco para ordenar nodos: lo que sueltes dentro se mueve con él. Borrar el grupo no borra sus nodos.
- Nota — Una nota de texto en el lienzo; no participa en la ejecución.
Cómo se comunican los nodos
Cada nodo tiene puertos —los círculos en sus bordes—. Los puertos de salida envían datos y los de entrada los reciben. Cuando trazas una línea de una salida a una entrada, creas una conexión que lleva los datos de un paso al siguiente. Por ejemplo, la imagen que produce un Generador puede fluir a un nodo de Iluminación para cambiarle la luz.
- Algunas entradas son obligatorias: el nodo no se ejecuta sin ellas.
- Por defecto, cada entrada acepta una conexión. Si conectas una nueva, reemplaza a la anterior.
- Algunas entradas aceptan varias conexiones: la de imagen del Generador (la primera es la base y el resto, referencias), las del Assistant y las de la Lista.
- Las salidas no tienen límite: puedes enviar un mismo resultado a tantos nodos como quieras. En los nodos que generan, la salida se arrastra a mano cuando ya hay un resultado.
Tipos de datos
Los datos fluyen entre nodos en dos tipos, y cada uno tiene su color. Solo puedes conectar puertos del mismo tipo —imagen con imagen, texto con texto—: si intentas conectar tipos incompatibles, la línea no engancha. No hay un tipo de video: el clip se queda en su nodo.
| Tipo | Color | Qué transporta |
|---|---|---|
| Imagen | Azul | Fotos, renders y la vista de un Modelo 3D |
| Texto | Violeta | Prompts: los que escribes y los que generan el Assistant, el Scanner, el Extractor de moods o el Estilo |
Conectar nodos
Hay varias formas de cablear nodos. Usa la que te resulte más rápida.
- Arrastra de puerto a puerto
- La forma más directa. Mantén pulsado un puerto de salida, arrastra la línea por el lienzo y suéltala en un puerto de entrada compatible.
- Arrastra a un espacio vacío
- ¿No sabes qué nodo necesitas? Arrastra desde cualquier puerto a un espacio vacío y se abre el menú de nodos, filtrado para mostrar solo los compatibles con ese puerto.
- Acerca un nodo o usa la conexión rápida
- Si sueltas un nodo cerca de otro con un puerto libre compatible, se conectan solos. Y «Conexión rápida», en la barra de un nodo, abre el menú con los nodos compatibles: el que elijas sale ya conectado.
Bueno saber
- Las conexiones siempre van de salida a entrada, nunca al revés.
- No puedes conectar un nodo consigo mismo ni crear ciclos: el flujo siempre avanza.
- Al arrastrar una conexión, los puertos compatibles se iluminan con su color y el resto se atenúa.
- Para quitar una conexión, pasa el cursor sobre la línea y pulsa las tijeras, o selecciónala y pulsa Supr. Con la herramienta Cortar (C) cortas varias de un trazo.
Qué se conecta con qué
Cada tipo de nodo acepta entradas concretas y produce salidas concretas. Úsala como referencia rápida al construir tus flujos.
| Nodo | Acepta como entrada | Produce como salida |
|---|---|---|
| Imagen («Subir») | — (nodo de origen) | Imagen |
| Referencia | — (nodo de origen) | Imagen |
| Modelo 3D | — (el modelo entra como archivo) | Imagen (la vista elegida) |
| Texto | — (nodo de origen) | Texto |
| Scanner de imagen | Imagen (obligatoria) | Texto |
| Extractor de moods | Imagen (opcional: también una foto dentro del nodo, o el mood escrito a mano) | Texto |
| Estilo | — (nodo de origen) | Texto |
| Assistant | Imágenes y textos (varios) | Texto |
| Generador de imagen | Imágenes (varias; la primera es la base) y Texto. Hace falta al menos uno de los dos | Imagen |
| Video | Imagen de primer fotograma (obligatoria), imagen de último fotograma (opcional, en los modelos que lo admiten) y Texto (opcional) | — (el clip se queda en el nodo) |
| Lista | Textos o imágenes (varios; un solo tipo por lista) | El mismo tipo |
| Mejorar render | Imagen (obligatoria) y Texto con notas (opcional) | Imagen |
| Iluminación | Imagen (obligatoria) | Imagen |
| Ángulos de cámara | Imagen (obligatoria) | Imagen |
| Escalador de imagen | Imagen (obligatoria) | Imagen |
Grupo y Nota no tienen puertos. Una misma salida puede alimentar varias entradas: por ejemplo, un Texto puede ir a la vez a un Generador y a un Assistant.
Ejecutar tu flujo
Solo los nodos que generan algo tienen botón de ejecutar: ▶ «Generar» (↻ «Regenerar» cuando ya hay resultado) corre ese nodo. Con el nodo seleccionado, la flecha ⌄ junto a ▶ abre «Modos de ejecución», y cada modo muestra su costo en tokens antes de correr. El Escalador y el Video solo tienen su botón.
| Modo | Qué hace | Cuándo usarlo |
|---|---|---|
| Ejecutar nodo | Ejecuta solo el nodo seleccionado, con los datos que ya tiene en sus entradas. | Ajustaste una sola opción —como el modelo— y quieres volver a correr ese paso. |
| Ejecutar desde aquí | Ejecuta el nodo seleccionado y todo lo que va después de él. | Cambiaste algo a mitad del flujo y quieres reprocesar desde ahí sin gastar tokens en los pasos previos. |
| Ctrl + Enter | Con un Generador o un Assistant seleccionado, ejecuta todo el flujo conectado, desde el principio. | Quieres correr la cadena completa de una vez. |
Para cancelar, pulsa «Cancelar» (✕) en el nodo que está generando: también se detiene el resto de la cadena, y lo que ya estaba hecho se conserva en el historial. Si el trabajo seguía en cola, se devuelven sus tokens; si ya había empezado, termina y se entrega.
Estados del flujo
Cada nodo muestra su estado para que sigas el progreso de un vistazo.
| Estado | Qué significa |
|---|---|
| Inactivo | Listo para ejecutar, todavía sin resultado. No lleva etiqueta. |
| En cola | En espera de que terminen los nodos anteriores. |
| Generando | La IA está creando el resultado; la etiqueta muestra el tiempo restante. |
| Completado | Listo: el resultado aparece en el nodo. Tampoco lleva etiqueta. |
| Error | Algo salió mal: pasa el cursor sobre la etiqueta «Error» para ver el motivo. |
| Cancelado | Cancelaste la ejecución. |
Procesamiento por lotes con Lista
Conecta una Lista con varios ítems a un Generador y se ejecuta una vez por cada ítem marcado. En una Lista de texto, cada ítem se suma al prompt; en una de imágenes, cada imagen entra como referencia sobre la misma base (o es la base, si no hay otra). Cada ítem es un render y se cobra, y las variantes no se aplican. Por ahora los lotes funcionan con NanoBanana PRO y NanoBanana Turbo.
Tokens y costo
Los nodos que generan consumen tokens, y el costo se ve antes de correr: en el chip del modelo del Generador, en el menú de modos, en el panel ⚙ y en la etiqueta de Mejorar render, el Escalador, el Video y Ángulos de cámara. En el Generador influyen el modelo, la resolución, las variantes y los ítems de una Lista; GPT Image y Seedream 5 suman además 5 tokens por cada imagen extra que conectes. Iluminación cuesta 20, Ángulos de cámara 10 y el video se cobra por segundo. El Assistant, el Scanner de imagen, el Extractor de moods, el Estilo y el Agente no cobran: cobra el nodo que genera después. Los precios de cada modelo están en «Modelos de IA».
Consejos y buenas prácticas
- Descubre nodos compatibles desde un puerto. Arrastra a un espacio vacío y el menú se abre filtrado por el tipo de dato.
- Usa «Ejecutar desde aquí» al iterar: ahorra tiempo y tokens porque no repite los pasos anteriores que no cambiaron.
- Ramifica tu flujo. Conecta una salida a varias entradas para procesar lo mismo de formas distintas y comparar.
- Sigue los colores. Azul es imagen y violeta es texto: te ayudan a rastrear el flujo de un vistazo.
- En el Generador, la primera imagen conectada es la base y el resto son referencias; el tipo de cada una se elige en su nodo o en el panel ⚙. Para cambiar la base, reconecta las imágenes en otro orden.