ArchiNode

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?».

Un flujo típico: una imagen base y un texto entran al Generador, que produce el render.

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.

Cada nodo tiene puertos: las entradas, a la izquierda, reciben datos; la salida, a la derecha, los envía. El color indica el tipo.
  • 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.

TipoColorQué transporta
ImagenAzulFotos, renders y la vista de un Modelo 3D
TextoVioletaPrompts: los que escribes y los que generan el Assistant, el Scanner, el Extractor de moods o el Estilo
Los cables llevan el color de su tipo: azul para imagen, violeta para texto.

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.

NodoAcepta como entradaProduce 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 imagenImagen (obligatoria)Texto
Extractor de moodsImagen (opcional: también una foto dentro del nodo, o el mood escrito a mano)Texto
Estilo— (nodo de origen)Texto
AssistantImágenes y textos (varios)Texto
Generador de imagenImágenes (varias; la primera es la base) y Texto. Hace falta al menos uno de los dosImagen
VideoImagen 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)
ListaTextos o imágenes (varios; un solo tipo por lista)El mismo tipo
Mejorar renderImagen (obligatoria) y Texto con notas (opcional)Imagen
IluminaciónImagen (obligatoria)Imagen
Ángulos de cámaraImagen (obligatoria)Imagen
Escalador de imagenImagen (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.

ModoQué haceCuándo usarlo
Ejecutar nodoEjecuta 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 + EnterCon 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.

EstadoQué significa
InactivoListo para ejecutar, todavía sin resultado. No lleva etiqueta.
En colaEn espera de que terminen los nodos anteriores.
GenerandoLa IA está creando el resultado; la etiqueta muestra el tiempo restante.
CompletadoListo: el resultado aparece en el nodo. Tampoco lleva etiqueta.
ErrorAlgo salió mal: pasa el cursor sobre la etiqueta «Error» para ver el motivo.
CanceladoCancelaste 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.

Nodes (Beta)