Connections

Ports, data types, and how to wire nodes together.

Port types

Every node has input and output ports. Ports are typed — you can only connect compatible types.

TypeDescriptionExample
textString dataPrompts, responses, captions
imageImage fileGenerated images, uploaded photos
videoVideo fileGenerated videos, uploaded clips
audioAudio fileVoiceovers, music, recordings
flexibleAny typeContext ports that accept multiple types

Creating a connection

  1. Hover over an output port (right side of a node)
  2. Drag from the port — a cable follows your cursor
  3. Drop onto a compatible input port (left side of another node)
  4. The cable snaps into place
Port direction matters: Every port has a direction field — either input or output. You connect outputs → inputs, never the reverse.

Common port patterns

Text chain

TextInput [text→] ──→ [←prompt] Gemini [response→] ──→ [←prompt] NanoBanana

Multi-input AI node

TextInput "brand data"    ──→ [←prompt]
                                       Gemini ──→ output
TextInput "instructions"  ──→ [←system_instruction]

Parallel branches

                    ┌──→ NanoBanana (image)
Gemini response ──→─┤
                    └──→ ElevenLabs (voiceover)

Validation rules

  • Type compatibility: text output can only connect to text or flexible input
  • No cycles: the editor prevents connections that would create loops
  • One source per input: each input port accepts one connection (except flexible)
  • Multiple outputs: an output port can connect to multiple inputs (fan-out)

Deleting a connection

Click the cable to select it, then press Delete or Backspace.

Last updated: 2026-03-27

    Connections | Zephly