ComfyUI Node
LTX Director (Koolook)
Same as Prompt Relay Encode, but local prompts and segment lengths are edited visually as draggable blocks on a timeline. The duration_frames input only sets the timeline scale (pixel space) — actual frame count is still read from the latent.
LTX Director (Koolook)
- model
- clip
- audio_vae
- optional_latent
- model
- positive
- video_latent
- audio_latent
- guide_data
- frame_rate
- combined_audio
◄global_prompt►
◄duration_frames120►
◄duration_seconds5.00►
◄timeline_data►
◄local_prompts►
◄segment_lengths►
◄epsilon0.0010►
◄guide_strength►
◄use_custom_audiofalse►
◄frame_rate24►
◄display_modeseconds►
◄custom_width0►
◄custom_height0►
◄resize_methodmaintain aspect ratio►
◄divisible_by32►
◄img_compression18►
◄relay_overrides►
◄audio_transcript_json►
CategoryKoolook/PromptRelay
Inputs (22)
| Name | Type | Default | Description |
|---|---|---|---|
| model | MODEL | — | |
| clip | CLIP | — | |
| global_prompt | STRING | Conditions the entire video. Anchors persistent characters, objects, and scene context. | |
| duration_frames | INT | 1201–10000 | Total timeline length in pixel-space frames. Used by the editor for visual scale only. |
| duration_seconds | FLOAT | 5.000.1–1000 | Total timeline duration in seconds (computed/synced from frames). |
| timeline_data | STRING | JSON state of the timeline editor (auto-managed; do not edit by hand). | |
| local_prompts | STRING | Auto-populated from the timeline editor. | |
| segment_lengths | STRING | Auto-populated from the timeline editor (pixel-space frame counts). | |
| epsilon | FLOAT | 0.00100.0001–0.99 | Penalty decay parameter. Values below ~0.1 all produce sharp boundaries (paper default 0.001). For softer transitions, try 0.5 or higher. |
| guide_strength | STRING | Auto-populated from the timeline editor (comma-separated guide strengths for image segments). | |
| audio_vaeopt | VAE | Optional. Connect an Audio VAE to generate audio latents. | |
| optional_latentopt | LATENT | Optional. Connect a latent to override the auto-generated one. | |
| use_custom_audioopt | BOOLEAN | false | Toggle between using timeline audio (ON) and generating audio from scratch (OFF). |
| frame_rateopt | FLOAT | 241–240 | Frames per second — only affects how time is displayed in the timeline editor when time_units is set to 'seconds'. |
| display_modeopt | COMBO | seconds | Display the ruler, segment ranges, length input, and total in frames or seconds. Internal storage is always pixel-space frames. |
| custom_widthopt | INT | 00–8192 | Target output width for all image segments. Set to 0 to use the original image width. |
| custom_heightopt | INT | 00–8192 | Target output height for all image segments. Set to 0 to use the original image height. |
| resize_methodopt | COMBO | maintain aspect ratio | How to resize image segments to fit the target dimensions. |
| divisible_byopt | INT | 321–256 | Snap the final output image dimensions to be divisible by this number (e.g. 32 for LTX). |
| img_compressionopt | INT | 180–100 | H.264 CRF compression to apply to each guide image. 0 = no compression, higher = more artefacts. |
| relay_overridesopt | STRING | Koolook: JSON dict of Prompt Relay per-stream overrides. Empty = upstream defaults. Supported keys: video_strength (float), video_window_scale (float), audio_strength (float), audio_window_scale (float), audio_epsilon (float). Example: {"video_strength": 10.0}. Underscore-prefixed keys are ignored. | |
| audio_transcript_jsonopt | STRING | Koolook: optional timed speech transcript JSON. Paste or link {"phrases":[{"start":0,"end":0.5,"text":"What?"}]} to auto-build local_prompts, segment_lengths, and timeline_data before Prompt Relay conditioning runs. |
Outputs (7)
| Name | Type | Description |
|---|---|---|
| model | MODEL | — |
| positive | CONDITIONING | — |
| video_latent | LATENT | Auto-generated LTXV empty latent (only populated when no latent is connected). |
| audio_latent | LATENT | Auto-generated audio latent (uses custom audio if enabled). |
| guide_data | GUIDE_DATA | — |
| frame_rate | FLOAT | The frame rate used for the timeline. |
| combined_audio | AUDIO | Combined timeline audio layout. |