Guide
English
Search the docs⌘K
9.1

Connections

The lines on the DOTV canvas are not decoration. A line says one thing: the one on the left is an input to the one on the right. So a glance at a canvas tells you how the AI video was made — which image referenced what, which frame a clip was built from. This section covers what a line actually feeds to the next node, how to wire one up, how to build the next step while you're at it, and how to cut one.

What a line carries

An edge is who feeds whomEdges have direction: the one on the left is an input to the one on the right. So when this one generates, it hands the character art to the model along with the prompt.
1 / 4
Two reference images, each with a line running to the storyboard frame on the right.

A line is not a "relation", it is material. When the node on the right starts generating, everything wired into it goes to the model together. Which is why what can feed what is not open-ended — an effect phrase pasted into an image request does nothing at all, and a line that is wired but unused only misleads you, so it is blocked at the moment you draw it:

The line itself runs square and steers around cards: two cards set at an angle never produce a wire that cuts diagonally across some other node. When one side of a node carries several lines, the openings spread a little above and below each other and the middle stretch of each wire takes its own lane, so the lines run parallel the whole way instead of merging into one thick line somewhere.

This node Only takes
Image Images (as a reference image), style samples
Video Images (as the first frame / a reference), videos (as a reference video in omni-reference mode), effect samples
Text / script Text and scripts (as the source text, written on top of it), images, video (the model reads the picture or the footage)
Audio Text, scripts
Smart edit Video
Frame study Video
3D previz Images (as the panoramic backdrop)
Style / effect sample Nothing at all — a sample dropped in from the libraries has no upstream

The audio row is the exception: a dub reads the text in its own input bar, and a script wired into it never reaches the request — that line only records where the dub came from.

The lines from style and effect samples go further: wiring one up is applying that look — its cover appears on the input bar right away (see 10.4), and on a node that has not generated yet the ratio switches over with it. Only one of each can be attached at a time: apply a new one and the old line disappears by itself.

A node can take several sources, and the order does not matter — in the picture above, the character sheet and the set image were fed to the same shot together.

Groups are not on this table: lines run between nodes, and there is nothing to attach to a group's bed (see 9.2).

Wire one up

Three ways, same result:

  • Drag from a handle: move the mouse over a card and a "+" appears on each side; hold the right-hand one and drop it on the target node.
  • Select two nodes and press ⌘L: click the source, hold ⇧ and click the target, then ⌘L. The direction is first clicked → clicked second, the same as dragging a handle (whatever you touch last is the target). Two nodes picked with a marquee have no order, and the one created first on the canvas is taken as the source; if it comes out backwards, cut it (below) and wire it again.
  • Ask Agent: "wire these two into that video node".

The "+" on the left runs the other way — dragging from it adds a reference to this node.

When one end is an empty video that has never produced anything and the other is a video that already has its result, the gesture does not decide the direction: the finished one is always the source, and the empty video takes it as a reference video (the same for dragging and ⌘L).

The two openings follow the table above: a node that can feed nothing has no "+" on the right (audio, smart edit, 3D previz, frame study), and a node that takes nothing has none on the left (style and effect samples, and text nodes you wrote by hand).

Build the next step while you are at it

Click the "+" instead of dragging, and a menu opens:

Click the +: Generate from this nodePick a kind and a new node is built on the right, already connected. Dragging an edge onto empty canvas opens the same menu — the new node lands wherever you let go.
Generate from this node, opened from the "+" on the right.

Pick a type and the new node is created on the right and wired up — no building a node and then coming back to connect it. Dragging a line and letting go on empty canvas opens the same menu; the only difference is that the new node lands where you let go.

The "+" on the left opens the same menu under a different title, Generate a node to reference: the new node is built on the left and wired into the current one.

The menu always holds the same types, and the ones you cannot reach from here are greyed out (open it on a style sample and only Image is live; on an image node it is image, video and script) — the positions never move, so you remember which one is where, and the greyed rows say plainly that this route does not lead there.

Cut one

Rest the mouse on a line and it thickens, with a pair of scissors in the middle; click them and it is cut. Both nodes stay where they are, they just stop being inputs to each other.

You can also delete it from the referencing node's composer: each reference thumbnail in that row has an ×, and removing one is the same as cutting that line.

Cutting the line from a style or effect sample is a bigger deal: it un-applies the look, and the style comes off the input bar with it. Deleting the sample node, or clicking the × on the cover in the input bar, does exactly the same thing.

Try it in DOTVReading only goes so far: open DOTV and make an AI video with the feature this section covers.