ComfyUI の Load Checkpoint ノード
Load Checkpoint(CheckpointLoaderSimple)は、.safetensorsまたは.ckptのモデルファイルを開いて、ワークフローで必要な3つのパーツ、つまりdiffusion MODEL、CLIPテキストエンコーダー、VAEを出力します。
Load Checkpoint の役割
Load CheckpointはほとんどのComfyUIグラフで最初に使うノードです。models/checkpointsフォルダから1つのチェックポイントファイルを読み込み、グラフの他の部分が使う3つのオブジェクトに分けます:MODEL(ノイズ除去をするUNetやトランスフォーマー)、CLIP(プロンプトを条件付けに変えるテキストエンコーダー)、VAE(ピクセルと潜在空間の間のエンコーダー/デコーダー)。
このノードにはckpt_nameというドロップダウンが1つあり、ComfyUIがcheckpointsフォルダ(とextra_model_paths.yamlの追加パス)で見つけたファイルをすべてリストアップします。ファイルを選んで3つの出力をつなげば、そのモデルファミリーがグラフ全体に設定されます。SD 1.5、SDXL、Pony、Illustrious、ほとんどのマージ済みチェックポイントはこのノードで読み込みます。Flux、SD3、ビデオモデルは通常、UNet、テキストエンコーダー、VAEが別々のファイルで提供されるので、代わりにLoad Diffusion Model、DualCLIPLoader、Load VAEを使います。
入力
名前 | 型 | 意味 |
|---|---|---|
ckpt_name | COMBO | models/checkpointsから選ぶ読み込むチェックポイントファイル。ページ読み込み時にリストが読み込まれ、新しいファイルはノードリストの更新後に表示されます。 |
出力
名前 | 型 | 意味 |
|---|---|---|
MODEL | MODEL | ノイズ除去ネットワーク。KSampler、LoRAローダー、ControlNet、モデルパッチノードに接続します。 |
CLIP | CLIP | テキストエンコーダー。正負のプロンプト用にCLIP Text Encodeに接続します。 |
VAE | VAE | ピクセルと潜在空間の変換器。VAE DecodeとVAE Encodeに接続します。 |
Load Checkpoint の使い方
- チェックポイントをComfyUI/models/checkpoints(またはextra_model_paths.yamlにあるフォルダ)にコピーする。
- ダブルクリック検索でノードを追加:"Load Checkpoint"と入力。
- ckpt_nameでファイルを選ぶ。
- MODELをKSamplerのモデル入力に、CLIPを両方のCLIP Text Encodeノードに、VAEをVAE Decodeに配線する。
- グラフの他の部分をモデルファミリーに合わせる:SD 1.5は512か768の潜在空間、SDXLは1024。
設定とコツ
- .safetensorsファイルを優先して使おう。.ckptはPythonのピクル形式で、読み込み時にコードが実行されることがある。
- チェックポイントにVAEが含まれていないと色が薄く見える。対応するVAEをLoad VAEで読み込み、チェックポイントのVAE出力の代わりに使う。
- 1つのLoad Checkpointは複数のサンプラーに供給できる。hiresパス用に2つ目のローダーは不要。
- 読み込みはキャッシュされる:最初の読み込み後は2つのチェックポイントを切り替えるのが速いが、それぞれがRAMに残る。
- Load LoRAはこのノードとサンプラーの間に使う。前に使うとダメ。LoRAはここから出るMODELとCLIPにパッチを当てる。
Load Checkpoint のトラブルシューティング
ckpt_nameが「undefined」になるかドロップダウンが空になる
原因
ComfyUI起動時にmodels/checkpointsにチェックポイントが見つからなかった、またはワークフローが存在しないファイル名で保存されている。
対処法
最低1つの.safetensorsファイルをComfyUI/models/checkpointsに入れて、Rキーでノード定義を更新し、もう一度ファイルを選ぶ。共有ワークフローなら同じファミリーのローカルチェックポイントを選ぶ。
ヘッダーの逆シリアライズ中にエラー:HeaderTooLargeまたはMetadataIncompleteBuffer
原因
ファイルが完全なsafetensorsファイルではない。多くはダウンロードが途中で止まったか、HTMLのエラーページが.safetensorsとして保存された。
対処法
ファイルサイズをダウンロードページと比べて確認し、再度ダウンロードする。正常なSDXLチェックポイントは約6.5GB。数キロバイトのファイルはエラーページ。
有効なチェックポイントなのに画像がノイズや灰色の四角になる
原因
チェックポイントのファミリーがグラフの他の部分と合っていない。例えばSDXLモデルで512x512潜在空間やSD 1.5設定、またはFlux UNetをLoad Checkpointで読み込んだ場合。
対処法
モデルファミリーの解像度とサンプラー設定を使う(SDXLは1024x1024、cfgは5-8)。Flux、SD3、WanはLoad Diffusion Modelと別のCLIP、VAEローダーを使う。
コンソールにClip missing: ["text_projection.weight"]や"clip missing"の警告が出る
原因
チェックポイントがテキストエンコーダーの一部なしで保存された。ComfyUIはデフォルトで埋めるが、スタイルが少し変わることがある。
対処法
これは警告であって失敗ではない。結果がモデルページと違うなら、同じファミリーの完全なチェックポイントからCLIPを読み込み、そのCLIP出力を使う。
チェックポイント読み込み直後にメモリ不足になる
原因
チェックポイント全体をGPUに移すとき、モデルが必要とするVRAMより空きが少ない。多くは他のプログラムや別のComfyUIタブがメモリを使っているため。
対処法
他のGPUプログラムを閉じる、--lowvramか--normalvramオプションでComfyUIを起動する、またはLoad Diffusion ModelでUNetをfp8で読み込む。6GBのカードでも--lowvramでSDXLが動く。
Load Checkpoint に関する質問
Load CheckpointはCheckpointLoaderSimpleと同じ?
はい。CheckpointLoaderSimpleは内部クラス名で、メニューにはLoad Checkpointと表示されます。古いCheckpointLoaderは設定ファイルのドロップダウンがあり、もう使われていません。
このノードでLoRAを読み込める?
いいえ。LoRAはLoad LoRAに入れます。Load LoRAはこのノードからのMODELとCLIPを受け取り、パッチ済みのものを返します。
なぜFluxモデルがリストに出てこない?
FluxはUNetファイルとして配布され、models/unet(またはmodels/diffusion_models)に置きます。Load Diffusion Modelで読み込み、DualCLIPLoaderとLoad VAEを追加してください。
関連ノード
Load Diffusion Model
ComfyUI core
Load Diffusion Model (UNETLoader) は、Flux、SD3.5、Wan、HunyuanVideo などのシンプルなノイズ除去ネットワークを models/diffusion_models から読み込みます。weight_dtype オプションで fp8 を選べば VRAM を節約できます。
Load LoRA
ComfyUI core
Load LoRA(LoraLoader)は、LoRAファイルをMODELとCLIPに別々の強さで適用します。これにより、スタイルやキャラクター、コンセプトを任意のチェックポイントにマージせずに追加できます。
Load VAE
ComfyUI core
Load VAE (VAELoader)はmodels/vaeから単独のVAEファイルを読み込みます。これにより、VAEがないか弱いチェックポイントでもきれいな色でデコードでき、FluxやWanのような分割モデルはデコーダーを取得できます。
CLIP Text Encode (Prompt)
ComfyUI core
CLIP Text EncodeはテキストプロンプトをモデルのテキストエンコーダーでCONDITIONINGに変換します。1つのノードがポジティブプロンプトを、もう1つがネガティブプロンプトを持ちます。
KSampler
ComfyUI core
KSamplerはノイズ除去のループを実行します。モデル、プロンプト、潜在変数を受け取り、シード、ステップ数、cfg、サンプラー、スケジューラー、denoiseで制御された完成した潜在画像を出力します。
その他の ComfyUI ノード
ComfyUI Manager
ComfyUI-Manager
ComfyUI Managerは、インターフェース内からカスタムノードパックやモデルのインストール、更新、修正を行い、インポートしたワークフローの不足ノードを解決し、設定のスナップショットを作成する拡張機能です。
Save Image
ComfyUI core
Save ImageはIMAGEテンソルをPNGとしてComfyUI/outputに保存します。ファイルのメタデータにワークフロー全体が埋め込まれているので、その画像をComfyUIにドラッグするとグラフを復元できます。
VAE Decode
ComfyUI core
VAE DecodeはサンプリングされたLATENTをVAEを使ってピクセルのIMAGEに変換します。VAE Decode (Tiled)はとても大きな画像をタイル単位で同じ処理をします。
Empty Latent Image
ComfyUI core
Empty Latent Imageは、テキストから画像を生成するときのスタート地点となる空の潜在キャンバス(幅、高さ、バッチサイズ)を作ります。サイズは8の倍数で、モデルファミリーに合っている必要があります。
Load Image
ComfyUI core
Load ImageはComfyUIの入力フォルダ(またはアップロード)から画像を読み込み、IMAGEテンソルとアルファチャンネルから作られたMASKを出力します。これはimg2img、インペインティング、ControlNet、IP-Adapterのグラフのスタート地点になります。
Apply ControlNet
ComfyUI core
Apply ControlNetは、ガイド画像と読み込んだControlNetを正負のCONDITIONINGに強さや開始・終了の割合で付け加えて、サンプラーがガイドのエッジや深度、ポーズに従うようにします。
