Skip to main content
An edge is a directed wire from one node to another. The downstream node receives the upstream node’s output as part of its prompt context. Think of it like attaching an image or file to a message in an AI chat — when you connect one node to another, Melius appends the upstream node’s data (its text, image, video, or audio) to the end of the downstream node’s input. The downstream model sees your prompt plus whatever the upstream node produced.

​
Edge data types

Edges are typed. The type matches the upstream output:
  • text — written output from a text node or the literal content of a custom_text node.
  • image — a generated or uploaded image.
  • video — a generated video clip.
  • audio — a generated or uploaded audio clip.
  • file — an uploaded image asset.
Downstream nodes accept the input types supported by their selected model. A text-to-image model accepts a text prompt; using an image reference requires a model with image inputs. When you switch an image or video node’s model, its prompt reference strip shows connections to inputs the selected model accepts. Other connections stay saved and reappear when you switch back to a compatible model. Saved @mentions remain in your prompt, with a warning when the model skips their inputs. You can still run the node with its supported inputs.

​
Creating edges

  • By dragging — drag from a source node’s output handle to a target node’s input handle.
  • By @-mention — type @ inside a prompt and pick a node. Melius creates an input edge automatically.
  • Programmatically — see edge_create.

​
Connect one source to several nodes

  1. Hold Shift and click each destination node to select it.
  2. Drag the source node’s output to a matching input on any selected destination.
  3. Check the preview wires, then release to connect all compatible selected destinations.
For example, select your image and video nodes, then drag a text node’s output to one selected node’s Text input. Every compatible selected node receives the shared text alongside its own prompt. You can mix destination types and select individual nodes inside groups. Unselected siblings are not connected. Destinations that cannot accept the input are labeled in the preview, and existing connections are skipped. One undo removes the connections created by the gesture. Dropping onto an unselected node creates a single connection. Dragging from an input back to an output keeps the existing behavior for that direction.

​
Connect several sources at once

  1. Hold Shift and click each source node to select it.
  2. Drag the output of any selected source to the destination input.
  3. Check that a preview wire leaves every selected source, then release.
The selected sources must all produce the same type of output, such as images and uploaded image files. This includes nodes inside a group, whether you select them one by one or drag a selection box around the group. If any selected source produces a different output, only the node you dragged from connects.

​
Removing edges

Click an edge to select it, then press Delete. Removing the edge does not affect either node’s existing versions — only the next run will reflect the change.
Last modified on September 25, 2026