Nodes/comfyui-easyapi-nodes/Save Single Image Without Output
ComfyUI Node

Save Single Image Without Output

Save exactly one image, no gallery clutter

By lldacing·Created 3 years ago·Updated 8 months ago· 96
Save Single Image Without Output
  • image
  • file_path
filename_prefixComfyUI
full_file_name
output_dir
addMetadatafalse

This is the single-image sibling of SaveImagesWithoutOutput, and the difference is right there in the name: where that node writes a whole batch, this one only ever processes one image - the pack author's own description is explicit that it handles just a single item. It writes the file to disk, skips registering as a gallery/API-visible output, and gives you the exact path it wrote so you can pick the file back up later in the graph.

Same family, same reason to exist: it's for people driving ComfyUI headlessly through comfyui-easyapi-nodes, lldacing's pack for API-first workflows, where you often want a file saved quietly to disk as a setup step rather than flagged as a "real" result - batch runs where you don't want every intermediate save cluttering the response, or lazy-evaluation chains where a downstream node only needs to fire once the file genuinely exists.

How it works

You feed it exactly one IMAGE, it writes it to the directory you specify under the filename you control, and - because it's not an output node - nothing about the save shows up in the run's visible outputs. The file_path result comes back as a plain string so a following node (LoadImageFromLocalPath, say) can read the file straight back in.

The inputs and outputs that matter

  • image (IMAGE, required) - a single image, not a batch.
  • filename_prefix (STRING, default "ComfyUI") - used the same way stock SaveImage uses it, as the base of the generated filename.
  • full_file_name (STRING, default empty) - the one input the batch version doesn't have. Set this to control the exact output filename directly, instead of relying on the prefix-plus-counter naming scheme.
  • output_dir (STRING, default empty) - where the file gets written.
  • addMetadata (BOOLEAN, optional, default false) - whether to embed workflow metadata in the saved file, same as stock SaveImage's equivalent setting.
  • Output: file_path - the exact path the image was written to.

How to install it

Via ComfyUI Manager, searching comfyui-easyapi-nodes. Manually:

cd ComfyUI/custom_nodes
git clone https://github.com/lldacing/comfyui-easyapi-nodes.git
cd comfyui-easyapi-nodes
pip install -r requirements.txt

Restart ComfyUI. No model downloads - pure file I/O.

Common issues & troubleshooting

Only one image out of a batch got saved. That's expected behavior, not a bug - this node is built to handle a single image only. If you're feeding it a batch, most implementations will just take the first one; if you actually need every image in a batch saved, use the plain SaveImagesWithoutOutput node instead.

full_file_name doesn't seem to do anything. Make sure you're actually setting it rather than leaving it at the empty default - with nothing set, the node falls back to the same prefix-based naming stock ComfyUI uses. Set full_file_name explicitly when you need a predictable, exact filename (useful when a downstream step or an external process needs to find the file by a known name rather than searching a directory).

Directory doesn't exist and the save fails. The pack has a config option, allow_create_dir_when_save, that controls whether missing output directories get created automatically - check that setting if writes are failing on a directory you expected to be created for you.

CategoryEasyApi/Image

Inputs (5)

NameTypeDefaultDescription
imageIMAGE
filename_prefixSTRINGComfyUI要保存的文件的前缀。可以使用格式化信息,如%date:yyyy-MM-dd%或%Empty Latent Image.width%
full_file_nameSTRING完整的相对路径文件名,包括扩展名。若为空,则使用filename_prefix生成带序号的文件名
output_dirSTRING目标目录(绝对路径),不会自动创建。若为空,存放到output目录
addMetadataoptBOOLEANfalse

Outputs (1)

NameTypeDescription
file_pathSTRING