Nodes/ComfyUI/Runway Aleph2 Keyframe
ComfyUI Node Runs on cloud

Runway Aleph2 Keyframe

Steer your edit at exact moments of the footage

By Comfy-Org·Created 4 years ago·Updated about 13 hours ago· 130,663
Runway Aleph2 Keyframe
  • image
  • keyframes
  • keyframes
timing

The Runway Aleph2 Keyframe node is a targeting tool for Runway's Aleph2 video-edit model. Aleph2 re-renders your existing footage under a new prompt - restyle, relight, swap elements - and this node lets you pin a guide image to a specific moment of that source video, so the edit lands the way you want at that exact point instead of trusting the whole clip to one prompt. It's the difference between "make it rain" and "make it rain specifically when the car appears."

This node does no generation itself. It takes a guide image and a timeline position, packages them into a RUNWAY_ALEPH2_KEYFRAME bundle, and hands it to the Runway Aleph2 Video to Video node's keyframes input. Chain several Keyframe nodes together and you're steering the edit at multiple points in the footage.

The inputs that matter:

  • image - the guidance image to apply at the chosen moment of the input video. Connect a Load Image.
  • timing - a dynamic combo deciding how you place it:
    • Absolute time (seconds) - 0 to 30 seconds from the start of the input video. For when the moment must hit a precise timecode.
    • Fraction - where in the video it applies, as a fraction of total duration (0.0 = start, 1.0 = end). Handy when you don't know the exact runtime.
  • keyframes - optional input of the same type. Chain the previous Keyframe node's keyframes output in here to accumulate up to 5 total.

Output is keyframes (RUNWAY_ALEPH2_KEYFRAME), wired to the keyframes input of the Aleph2 Video to Video node.

The rules that matter live in that downstream node. First, Aleph2 gives you two steering mechanisms - keyframes anchored to the input video, and "prompt images" anchored to the output video - and you're meant to use one or the other, not both. Second, the keyframe cap is 5; more than that and the node rejects the chain. Since these are positions on the source timeline, keep them sane relative to the source's length (2–30 seconds, 30 fps or lower for the V2V input).

Context worth having: this is Runway's new-model line, added to ComfyUI in mid-2026, and it runs on Runway's servers through your Comfy account - paid per generation, nothing local, sign-in required. If the partner-node family clutters your search, --disable-api-nodes removes it.

Categorypartner/video/Runway

Inputs (3)

NameTypeDefaultDescription
imageIMAGEThe guidance image to apply at the chosen moment of the input video.
timingCOMBOHow to place this image on the input video's timeline.
keyframesoptRUNWAY_ALEPH2_KEYFRAMEOptional earlier keyframes to chain with this one.

Outputs (1)

NameTypeDescription
keyframesRUNWAY_ALEPH2_KEYFRAME