IPAdapter モデルが見つからない：統合プリセットと手動ローダーでは規則が異なる
ダウンロードした IPAdapter ファイルがディスク上に存在していても、統合ローダーのプリセット照合条件を満たすとは限りません。ファイル名を変えたり移動したりする前に、使用中のローダーを特定します。
症状と対象範囲
ダウンロードした IPAdapter ファイルがディスク上に存在していても、統合ローダーのプリセット照合条件を満たすとは限りません。ファイル名を変えたり移動したりする前に、実際に失敗したノードを特定します。
検索の手掛かりとなるエラーの断片です。ID、値、ファイル名は環境によって変わります。
IPAdapter model not found.
IPAdapterUnifiedLoader
出典から確認できること
作者の README では、統合ローダーで読み込むには指定された名前が必要とされています。一方、旧式のモデルローダーでは ipadapter_file のドロップダウンが表示されます。ピン留めしたソースでは、get_ipadapter_file(preset, is_sdxl) が登録済みの ipadapter ファイル名を読み込み、プリセットとモデルが SDXL 系統かどうかに応じてパターンを選択します。一致する候補がない場合、統合ローダーは IPAdapter model not found. を発生させます。CLIP Vision はその前に検索され、読み込まれます。Vision の検出に失敗した場合は、それより前の段階に固有のメッセージが出ます。ファイル名が一致しても、中身の重みに互換性があるとは限りません。作者の README（英語） ピン留めした解決処理（英語） ピン留めしたローダー（英語）
区別すべき状況
1. 実行中のインスタンスの ipadapter ファイル一覧に候補がない。モデルパスが欠けている場合や、ダウンロードしたファイル名が一般的な名前のままの場合が考えられる。
2. 選択したプリセットと SD1.5／SDXL のモデル系統によって、別のファイル名パターンになる。または、明示的にサポートされていない組み合わせのエラーになる。
3. ファイル名は一致するが、ファイルの識別情報や中身、ビジョンエンコーダー、必要な FaceID LoRA が異なる。その結果、後の段階で読み込みや適用に失敗する。
確認手順
これは引用した資料に基づく編集上の手順であり、お使いのマシンの診断ではありません。
手順 1. 正確なノードクラス、例外、選択したプリセット、ベースモデルの系統を記録します。ClipVision model not found.、IPAdapter model not found.、LoRA model not found. と、その後に起きる読み込みエラーや形状エラーを区別します。
手順 2. 実行中のサーバーに登録された ipadapter のファイル名と、設定済みのモデルパスを調べます。インストール済みの get_ipadapter_file が、そのプリセットとモデル系統に対して使うパターンを、発行元の成果物の名前と識別情報に照らして確認します。パターンを満たすためだけに無関係な重みの名前を変えないでください。
手順 3. プリセットで必要な場合は、clip_vision と loras を別々に確認します。複数のファイル名が一致する場合は、インストール済みの解決処理が最初にどのファイルを選ぶかを調べます。
手順 4. ワークフローのコピーで、発行元がサポートするアダプター、ビジョンエンコーダー、ベースモデルを使い、参照画像 1 枚でテストします。手動の IPAdapterModelLoader ではファイル名を明示的に選べますが、互換性のあるコンポーネントの組み合わせはワークフローの作者が判断する必要があります。
完了の確認
実行中のインスタンスが目的のファイルを選択して読み込み、対応する最小限のワークフローがサンプリングまで進むことを確認します。ファイル名が一致するだけでは不十分です。
制限と注意点
作者はこのリポジトリをメンテナンスのみとしています。ピン留めしたソースが示すのは、一つの実装バージョンです。ここに記載したパターンを適用する前に、インストール済みノードの動作を確認してください。発行元へのリンクがあっても、このサイトが重みをダウンロードまたは検証したことにはなりません。
参照した原文資料
- IPAdapter Plus README（英語）（確認日：2026-09-26）
- ピン留めした IPAdapter ファイル名の解決処理（英語）（確認日：2026-09-26）
- ピン留めした統合ローダーと手動ローダー（英語）（確認日：2026-09-26）
資料と英語原文を確認した日付は 2026-09-26 です。このサイトではモデルをダウンロード、読み込み、実行していません。GPU テストや互換性の保証もしていません。
関連するトラブルシューティング記事とガイド
次に考えられる原因を確認
同じ症状にも異なる原因があります。関連する記事を順に確認してください。
- CLIP Vision が見つからない、または互換性がない：プロンプト用テキストエンコーダーとは別のもの
ClipVision model not found.参照画像を使うワークフローには、想定されたアーキテクチャのビジョンエンコーダーが必要です。CLIPTextEncode に入力されるオブジェクトとは区別してください。 - InsightFace のインストールまたは初期化に失敗する：パッケージと FaceID 用ファイルを分けて確認する
No module named 'insightface'insightface の不足、wheel のビルド失敗、初期化エラーでは、それぞれ別の確認が必要です。インタープリター、ネイティブビルド、実行バックエンド、モデルファイルを調べます。
この記事は役に立ちましたか？
匿名です。はい・いいえの件数のみ保存し、アカウント、IP アドレス、端末情報は保存しません。
出典と参考資料
2026-09-26 に作者の README と、ピン留めした a0f451a の IPAdapter ファイル解決処理、統合ローダー、手動モデルローダーを確認しました。英語原文のみを確認しており、モデルのダウンロード、ワークフロー、GPU 実行はしていません。
01IPAdapter Plus README（英語）出典の確認日: 2026-09-2602ピン留めした IPAdapter ファイル名の解決処理（英語）出典の確認日: 2026-09-2603ピン留めした統合ローダーと手動ローダー（英語）出典の確認日: 2026-09-26問題を報告 · aea57e1a-9e1b-5692-a8d8-0e68b6dd8119
関連記事
編集者がこのページに関連づけた記事です。
固定したソースでは、IPAdapterUnifiedLoader は MODEL とプリセットを読み込み、MODEL と IPADAPTER を返します。参照画像は後段の適用ノードに入力します。