Save Image KJ (SaveImageKJ) - ComfyUI-KJNodes

file: custom-nodes/ComfyUI-KJNodes/nodes/save-image-kj.md

Save Image KJ ノードは、ComfyUIのフォルダーパス管理システムに基づいており、入力された画像テンソルを一般的な画像形式（例：PNG）に変換し、指定されたディレクトリに書き込むことができます。

Save Image KJ ノードは、ComfyUIにおいて画像を保存するための出力ノードです。その中核機能は、ワークフローで生成された画像データをローカルディスクに保存し、保存されたファイルに説明的なテキストを付加することをサポートします。

ノード機能

このノードは、ComfyUIのフォルダーパス管理システムに基づいており、入力された画像テンソルを一般的な画像形式（例：PNG）に変換し、指定されたディレクトリに書き込むことができます。ファイル名に動的なフォーマット文字列（例：他のノードの属性値や現在の日付を参照する）を使用することをサポートしており、柔軟なファイル命名を実現します。さらに、ノードはオプションのテキスト入力インターフェースを提供し、ユーザーが保存する画像に対して独立したテキスト記述ファイルを生成することを可能にします。

ノードパラメータ説明 - Save Image KJ

接続入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`images`	IMAGE	はい	-	-	保存する画像。

コントロールパラメータ (Parameters)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`filename_prefix`	STRING	はい	ComfyUI	-	保存するファイルのプレフィックス。ノードからの値（例：%date:yyyy-MM-dd% や %Empty Latent Image.width%）を含めるためのフォーマット情報を含めることができます。
`output_folder`	STRING	はい	output	-	画像を保存するフォルダー。
`caption_file_extension`	STRING	いいえ	.txt	-	キャプションファイルの拡張子。
`caption`	STRING	いいえ	-	-	.txtファイルとして保存する文字列。

出力 (Output)

パラメータ名	データ型	説明
filename	STRING	保存ファイル名のプレフィックスを定義します。動的フォーマット文字列の使用をサポートします。

使用シナリオ

典型的な画像生成ワークフローでは、Kサンプラーや VAEデコードなどのノードから出力された最終画像を、このノードの「images」入力ポートに接続できます。その後、出力フォルダーとファイル名プレフィックスを設定すると、ノードはレンダリング結果を自動的に保存します。生成された各画像に対してプロンプトやメタデータを記録する必要がある場合は、これらのテキスト情報を「caption」入力ポートに接続できます。ノードはこれを同名のテキストファイルとして保存します。

注意事項

output_folder パラメータは相対パスまたは絶対パスを受け入れます。相対パスを使用する場合、ComfyUIの設定された出力ディレクトリを基準に解決されます。ComfyUIを実行するプロセスがターゲットフォルダーへの書き込み権限を持っていることを確認してください。そうでない場合、保存操作は失敗します。

Save Image KJ ノードソースコードリンク

Save Image KJ ノードは ComfyUI-KJNodes ノードパッケージに含まれています。

Save Image KJ(SaveImageKJ)

Save Image KJ