Comfy-Org/ComfyUI
Documented errors, page 2 of 8. Back to Comfy-Org/ComfyUI
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| destination escapes base directory | validation | error | upload, path-traversal, security, validation |
| Gemini did not generate an image. Model response | exception | error | comfyui, gemini, image-generation, empty-response, prompt-format |
| Adding guide to a combined AV latent is not supported. | validation | error | ltx, latent, shape, audio, validation |
| floats_strength must be either an iterable input or a… | validation | error | type-error, hooks, controlnet, strength, validation |
| No decodable video frames found in file | exception | error | video, transcode, no-decodable-frames, corrupt-file, pyav |
| Video size ( MB) exceeds 50MB limit. | exception | error | grok, xai, video-edit, file-size-limit, upload |
| Latent spatial size x must be divisible by… | validation | error | ltx, iclora, resolution, latent, validation |
| Minimum cutoff must be larger than zero. | exception | error | vocoder, audio, config, validation |
| `only_cross_attention` can only be set to True if… | validation | error | config, attention, constructor-validation |
| video length is too short | validation | error | wan, video, sampling, edge-case |
| SeedVR2 VideoAutoencoderKLWrapper.decode: 5-D latent input… | exception | error | seedvr, vae, decode, latent-shape |
| Unrecognized frame interpolation model format | validation | error | comfyui, frame-interpolation, rife, model-format |
| Unknown DINOv2 backbone variant | exception | error | depth-anything-3, dinov2, backbone, config |
| multi-view mode requires Small or Base model. The loaded… | validation | error | comfyui, depth-anything-3, model-capability, validation |
| Program linking failed:\n | exception | error | glsl, shader, linking, opengl |
| Could not determine frame count for file | exception | error | video, trim, frame-count, seek-out-of-range |
| Custom aspect ratio is only allowed when multiple images… | exception | error | grok, xai, image-editing, aspect-ratio, input-validation, comfy-api-nodes |
| No video files found in | validation | error | dataset, video, file-extension, comfyui |
| sync.so generation | validation | error | sync-so, lipsync, api-error, polling |
| ERROR: Could not detect model type of | exception | error | checkpoint-loading, model-detection, file-format |
| \n\nFile path: \n\nThe safetensors file is corrupt or… | validation | error | safetensors, checkpoint, corrupt-file, model-loading |
| SeedVR2Preprocess failed to pad video length to 4n+1; got | exception | error | seedvr, video, assertion, unreachable |
| The prompt references @Image | exception | error | grok, xai, prompt-template, input-validation, reference-tag, comfy-api-nodes |
| TripoSplat gaussian decoder: use the 'TripoSplat Decode'… | exception | error | vae, triposplat, gaussian-splatting, unsupported-operation |
| Either initial_mask or conditioning must be provided | exception | error | sam3, segmentation, tracking, conditioning, missing-input |
| No pre-releases found | exception | error | frontend, network, github-api, versioning |
| Input txt tensors must have 3 dimensions. | exception | critical | chroma-radiance, conditioning, tensor-shape, forward |
| Rodin Gen-2.5 accepts at most 5 images; received | validation | error | validation, rodin, image-batch, api-nodes |
| Audio duration must be at least | validation | error | audio, api-nodes, validation, input-validation |
| eglBindAPI(EGL_OPENGL_ES_API) failed | exception | error | egl, opengl, gles, driver, environment |
| Cached dims don't match x dims - this is no good | exception | error | comfyui, easycache, tensor-shape, caching |
| normalized element boxes need canvas_width and… | validation | error | validation, bounding-boxes, normalized-coordinates, comfyui |
| ObjectPatchHook is not supported yet in ComfyUI. | exception | error | hooks, not-implemented, model-patching, compatibility |
| SeedVR2 decoder only supports UpDecoderBlock3D, got | exception | error | seedvr, vae, config, decoder |
| A maximum of 7 reference images is supported; | exception | error | grok, xai, video-generation, reference-images, input-validation |
| resize produced no frames | validation | error | video, pyav, trim, validation |
| HeyGen returned no video_url for translation | exception | error | heygen, video-translation, render-failure, polling |
INVALID_HASH hash must be like 'blake3 | http | error | rate-limit, http-429, retry, throughput |
| Unsupported nerf_final_head_type | exception | critical | chroma-radiance, nerf, config, model-init |
| MiniMax Music3 tokenizer mismatch for | exception | error | minimax, music, tokenizer, model-loading |
| PixDiT_T2I requires context (text embeddings) of shape [B… | validation | error | pixeldit, conditioning, shape-mismatch, validation |
| The prompt references @Audio | exception | error | grok, xai, prompt-template, audio, input-validation, comfy-api-nodes |
| This Controlnet needs a VAE but none was provided, please… | exception | error | controlnet, vae, workflow |
| Unsupported noise schedule | validation | error | sampling, uni-pc, validation |
| Cannot create multigpu deepclone of | exception | error | model-patcher, multigpu, deepclone, custom-loader |
| Field ' ' cannot be shorter than characters; was characters… | validation | error | api-nodes, validation, prompt, string-length |
| SeedVR2 VideoAutoencoderKLWrapper.decode: 4-D latent input… | exception | error | seedvr, vae, decode, latent-shape |
| Failed to trim video | exception | error | video, pyav, wrapper-exception, trim |
| File3DToSplat: could not determine splat format from… | validation | error | gaussian-splatting, format-detection, invalid-input, file-format |
| Selected resolution ( p) is smaller than the input video's… | validation | error | hitpaw, video-enhance, resolution, aspect-ratio |
| Video too short: need at least 16 frames for Moonvalley | validation | error | video, pyav, frame-count, moonvalley, validation |
| Could not extract regex pattern from | validation | error | tokenizer, bpe, pre-tokenizer, json-config |
| Field ' ' cannot be empty. | validation | error | api-nodes, validation, prompt, null-check |
| Invalid image dimensions | validation | error | validation, image, tensor, shape |
| Invalid operation for morphology. Must be one of 'erode'… | exception | error | morphology, kornia, image-processing, invalid-argument, error-message-mismatch |
| No / encoder for -channel images: supported channel counts… | validation | error | image-io, channels, png, exr, validation |
| Seed Audio returned no audio | exception | error | comfyui, bytedance, seed-audio, api-error, network, content-moderation |
| Cannot create non-dynamic delegate: cached_patcher_init is… | exception | error | model-patcher, dynamic, clone, custom-loader, fast |
| SeedVR2 downsample expected | exception | error | seedvr2, vae, channels, config |
| SeedVR2 encoder only supports DownEncoderBlock3D, got | exception | error | seedvr2, vae, config, encoder, validation |
| Total storyboard duration | validation | error | kling, storyboards, duration, validation, pre-flight |
| @AudioN tags are not used in | validation | error | comfyui, bytedance, seed-audio, validation, prompt-format |
| frame_idx is past the end of the video's audio track | validation | error | minimax-h3, audio, frame-index, time-axis |
| Math Expression ' ' must evaluate to a numeric result, got | validation | error | math, expression, type-error, validation |
| no base path configured for category | validation | error | upload, models, configuration, server-setup |
| The current maximum number of supported images is 14. | exception | error | gemini, image-generation, input-validation, limit, comfy-api-nodes |
| torchaudio is not available; cannot resample audio. | exception | error | audio, dependency, resampling, opus, environment |
| folder_name must name a subfolder of the datasets… | validation | error | dataset, validation, filesystem, comfyui |
| Failed to upload one or more images to comfy api. | validation | error | runway, upload, api-nodes, network |
| MergeSplat: no gaussians to merge | validation | error | gaussian-splatting, empty-input, node, merge |
| Video resolution changes mid-stream | exception | error | video, transcode, resolution-change, corrupt-file |
| bboxes string input is not valid JSON | validation | error | json, validation, bounding-boxes, comfyui |
| Could not verify video duration from source | validation | error | video, upload, probe, metadata |
| SeedVR2 expected an even text-conditioning batch, got shape | validation | error | seedvr2, conditioning, batching, validation |
| Sonilo generation error | exception | error | sonilo, streaming, ndjson, music-generation |
| Color must be in format #RRGGBB or #RRGGBBAA | validation | error | validation, color, string-format, comfyui |
| Hooks not implemented in ModelPatcherDynamic. Please remove… | exception | error | model-patcher, hooks, fast, unsupported-combination |
| Ratios must be positive, got | validation | error | api-nodes, validation, aspect-ratio, developer-error |
| Expected key `target` to instantiate. | exception | error | config, serialization, instantiate, key-error |
| File3DToSplat: not a PLY (missing end_header) | validation | error | gaussian-splatting, ply, file-format, corrupt-file |
| keyframe_idxs holds tokens, which is not a whole number of… | validation | error | ltx, keyframes, resolution-mismatch, upsample |
| Normalization not found | exception | critical | cosmos, normalization, config, attention |
| The prompt references @Audio | validation | error | comfyui, bytedance, seed-audio, validation, workflow-wiring |
UNSUPPORTED_MEDIA_TYPE Use multipart/form-data for uploads. | http | error | http-4xx, validation, provider, http |
| Could not acquire lock on database | exception | error | database, sqlite, concurrency, startup |
| batch_index is out of range; DA3_GEOMETRY has batch size . | validation | error | comfyui, depth-anything-3, index-out-of-range, mesh |
| Invalid image tensor shape. | validation | error | validation, tensor, image, shape |
| Query heads must be divisible by key/value heads for GQA | exception | error | attention, gqa, config, heads |
| At least one input image is required | validation | warning | workflow, validation, glsl, node-inputs |
| eglCreateContext() failed | exception | error | egl, opengl, gles3, driver, glsl |
| LAYERS document version | validation | error | validation, layers-document, schema-version, comfyui |
| Runway task succeeded but no video data found in response. | validation | error | runway, api-response, polling, video-generation |
| At least 4 points are required to compute a homography. | exception | error | depth-anything-3, homography, geometry, input-validation |
| File3DToSplat: unsupported .ksplat version | validation | error | gaussian-splatting, ksplat, version-mismatch, file-format |
| Output dims don't match x dims - this is no good | exception | error | comfyui, easycache, tensor-shape, caching |
| Unsupported resize type | exception | error | resize, image-processing, enum, version-skew |
| No valid images found in input | validation | error | dataset, empty-input, comfyui |
| At least one reference image or video or asset is required. | validation | error | bytedance, seedance, validation, missing-input, api-nodes |
| Failed to download layer | exception | error | bytedance, seedream, layer-separation, network, download, api-nodes |
| Kling task succeeded but no video data found in response. | exception | error | kling, video-generation, task-result, upstream-inconsistency |