← Studio guide

Building graphs

Nodes, ports and connections

Port colours, what can connect to what, and why image will not plug into video.

Every node has input ports along its top and left, and output ports on its right. Ports are colour-coded by what they carry, and Studio refuses connections that do not make sense, so a wrong wire will not silently produce a broken run.

Port types

TextPrompts and any string value.
ImageA single still.
VideoA clip.
MaskA matte. Interchangeable with image in both directions.
3DGeometry and gaussian splats.
AudioSound, for models that take or make it.
AnyAccepts everything. Used by Dot and the iterators.

What connects to what

Matching colours always connect. Beyond that, image and mask are interchangeable in both directions, 3D and GLB are interchangeable, and Any accepts everything.

Image does not connect to video, on purpose. A port that wants video wants actual motion, and feeding it a still produces confusing failures deep inside a model. Nodes that animate a still take it on an image input instead.

Optional ports

Ports marked optional can be left empty. Reference image slots on video models are the common case: wire one if you want the look carried across, leave it alone if you do not. Each node's page in the node reference lists exactly which of its ports are required.

Reading a graph

Connections carry the colour of the port they leave, so you can trace a matte through a graph by following the one coloured line. Mask connections are drawn dashed to separate them from image ones at a glance.