ComfyUI Black Video Output: Causes and Fixes for Wan, LTX and HunyuanVideo

Updated 2026-10-09

Why ComfyUI saves an all-black video, how to tell which stage broke, and the fixes maintainers have confirmed: SageAttention, VAE precision, tiled decode and wrong VAEs.

Quick answer

An all-black video from ComfyUI almost always means the numbers went bad before they became pixels. Somewhere in the sampler or the VAE, values turned into NaN, "not a number". When ComfyUI converts the result to 8-bit pixels, every NaN becomes 0, and 0 is black. The console usually says so with one line:

RuntimeWarning: invalid value encountered in cast

The fixes that maintainers have confirmed, cheapest first:

  1. Remove --use-sage-attention from your launch command, and --fast fp16_accumulation if you added it. This is the most common cause on Wan.
  2. Run the VAE in full precision with --fp32-vae. ComfyUI's own help text says --fp16-vae "might cause black images".
  3. Check the VAE matches the model. Wan 2.2 5B needs wan2.2_vae; the Wan 2.2 14B models use wan_2.1_vae.
  4. Use plain VAE Decode, not VAE Decode (Tiled), on Wan.
  5. On a GTX 16-series card or on a Mac, read the hardware section below; ComfyUI already works around both, so something may be overriding it.

Change one thing at a time and run the same seed, so you know which change fixed it.

We read ComfyUI's source, its documentation and the issue threads cited below on 2026-10-09. ComfyUI's official troubleshooting pages do not cover black output; everything here comes from the code and from maintainers' replies in issues.

Find the stage that went black

Before changing flags, find out where the frames turn black.

  • Read the console. The invalid value encountered in cast warning, usually from the save node or VideoHelperSuite, confirms NaN. No warning and still black points elsewhere, such as an empty or wrong input image.
  • Save an image straight after VAE Decode. Add a Save Image node on the decoded frames. If that PNG is black too, the video encoder is not the problem. If the PNG is fine, look at the video save node and its format.
  • Watch the sampler preview. If the preview goes black or flat partway through sampling, the NaN came from the model or attention. If sampling previews look normal and only the decode is black, it is the VAE.
  • Rerun with --disable-all-custom-nodes on a built-in template. If it still goes black, a custom node is not the cause.

Causes and fixes

CauseModels seen onFixWho confirmed it
CauseSageAttentionModels seen onWan 2.1, Wan 2.2 I2V and AnimateFixRemove --use-sage-attention; in WanVideoWrapper, switch attention off sageWho confirmed itkijai, WanVideoWrapper's maintainer: the only time he saw it on Wan was SageAttention-related. A ComfyUI org member said the same for most black-output reports
CausePyTorch versionModels seen onWan in WanVideoWrapperFixChange the PyTorch version; kijai also asked whether torch.compile was onWho confirmed itkijai, same thread: usually SageAttention or the PyTorch version
CauseVAE in fp16Models seen onAny; HunyuanVideo in particularFix--fp32-vae, or --bf16-vae; in a wrapper, set the VAE precision to fp32Who confirmed itComfyUI's own --fp16-vae help text; kijai for HunyuanVideo: do not use the fp16 VAE
CauseWrong VAE for the modelModels seen onWan 2.2Fix5B: wan2.2_vae. 14B: wan_2.1_vaeWho confirmed itComfyUI's Wan 2.2 tutorial (the pairing; it does not mention black output)
CauseTiled VAE decodeModels seen onWan 2.1FixUse plain VAE DecodeWho confirmed itcomfyanonymous: the Wan VAE is already tiled in time, so the tiled node is unnecessary. The report was flicker and discoloured frames, not pure black
CausePyTorch attention on an old torchModels seen onHunyuanVideo (original), wrapperFixKeep the main model in bf16; on that wrapper, PyTorch attention only worked on torch 2.5.1Who confirmed itkijai, HunyuanVideoWrapper, December 2024
Causefp16 on GTX 16-series cardsModels seen onAnyFixLet ComfyUI use fp32, which it does by default on these cards; add --force-fp32 if something forces fp16Who confirmed itcomfyanonymous; a comment in ComfyUI's memory code says fp16 is broken on these cards
CausemacOS attention bugModels seen onAny, on Apple siliconFixComfyUI upcasts attention on macOS 14.5 and later; --force-upcast-attention forces itWho confirmed itA comment in ComfyUI's memory code

The GTX 16-series list in ComfyUI's code covers the GTX 1660, 1650 and 1630, the MX450 and MX550, and the T500, T550, T600, T1000, T1200 and T2000.

The flags, spelled exactly

From comfy/cli_args.py on ComfyUI's master branch, 2026-10-09. A wrong spelling is ignored or fails, so copy them.

What it changesFlags
What it changesVAE precisionFlags--fp32-vae, --bf16-vae, --fp16-vae, --cpu-vae
What it changesEverythingFlags--force-fp32, --force-fp16
What it changesDiffusion modelFlags--fp32-unet, --bf16-unet, --fp16-unet
What it changesAttentionFlags--use-pytorch-cross-attention, --use-sage-attention, --force-upcast-attention
What it changesIsolationFlags--disable-all-custom-nodes

Two help texts in that file mention black images directly: --fp16-vae "might cause black images", and --force-upcast-attention asks you to "report if it fixes black images".

--cpu-vae runs the decode on the processor. It is slow, but if the frames come out right on the CPU, the VAE's precision on your GPU is the problem.

By model

Wan 2.1 and Wan 2.2

Start with SageAttention; it accounts for most reports. Then check the VAE pair: the 5B and the 14B use different VAEs, and the Wan 2.2 models folder page lists which template loads which.

One user in the SageAttention thread also found that one lightx2v 4-step fp8 file gave black output while its _comfyui_ variant did not. That is a single report, but if you downloaded a lightx2v file outside the ComfyUI repack, try the repack's copy.

LTX-2 and later

LTX failures are more often noise or static than pure black:

  • Pure noise: the dev model run with the distilled 8-step settings and without the distilled LoRA. Load the distilled model instead.
  • Static: a tutorial reports that the GGUF dual text-encoder loader left on type sd3 instead of ltxv fills the video with static.

Both are covered with the 12GB setup on our LTX Video 12GB page.

HunyuanVideo and HunyuanVideo 1.5

The original HunyuanVideo's black output in kijai's wrapper came down to the fp16 VAE and the attention mode. HunyuanVideo 1.5's ComfyUI files ship the VAE as hunyuanvideo15_vae_fp16; if it goes black, --fp32-vae is the first thing to try.

Reports nobody has solved yet

  • Wan 2.2 image-to-video on an RTX 5070 Ti. The official template gives a black video and a black PNG after VAE Decode, even with all custom nodes disabled, on PyTorch 2.13 with CUDA 13.0. The issue is open, with no reply. NaN is the reporter's guess, not a confirmed cause.
  • HunyuanVideo 1.5 on Apple silicon. On an M2 Ultra, 73 frames came out fine, 81 to 97 frames came out black, and 121 frames failed with a tensor-size error. A tiled decode was suggested but not confirmed to work.

If your case matches one of these, adding your hardware and versions to the open thread helps more than a new one.

When it is not black but broken

Black output is a numbers problem. A missing file, a wrong folder or a memory error stops the run instead of finishing it black. For those:

GenVidKit is an independent guide. It is not affiliated with Comfy Org, Alibaba, the Wan team, Lightricks, Tencent, Kijai or Hugging Face.

Sources

All read on 2026-10-09.