Runway Aleph2 Keyframe
Steer your edit at exact moments of the footage
- image
- keyframes
- keyframes
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
keyframesoutput 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.
Inputs (3)
| Name | Type | Default | Description |
|---|---|---|---|
| image | IMAGE | The guidance image to apply at the chosen moment of the input video. | |
| timing | COMBO | How to place this image on the input video's timeline. | |
| keyframesopt | RUNWAY_ALEPH2_KEYFRAME | Optional earlier keyframes to chain with this one. |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| keyframes | RUNWAY_ALEPH2_KEYFRAME | — |