Easy Apply IPAdapter (From Params) ノード(ipadapterApplyFromParams)

Easy Apply IPAdapter (From Params) ノードは、事前に構築された IPADAPTER_PARAMS オブジェクトを使用して、diffusion モデルに IPAdapter モデルを適用します。これは通常の Easy Apply IPAdapter ノードのパラメータ優先版です。このノードで各アダプターオプションを直接設定する代わりに、上流で設定を構築し、ipadapter_params を通じて渡します。これによりワークフローをモジュール化でき、同じアダプター設定を異なるモデルや実験で簡単に再利用できます。

入力

model

IPAdapter が適用されるベースの diffusion モデル。出力 MODEL は、IPAdapter の条件付けが適用されたこのモデルの変更版です。

preset

読み込む IPAdapter プリセットを選択します。利用可能なオプションは、パッケージと ComfyUI によって、インストール済みのプリセットに基づいて提供されます。プリセットにより、適用時に使用される IPAdapter の重みとデフォルトの動作が決まります。

ipadapter_params

適用する IPAdapter 設定を含む IPADAPTER_PARAMS オブジェクト。適切な Params ノードを使用して上流で構築し、ここに渡します。このオブジェクトには通常、入力画像、重み、開始/終了パーセンテージ、その他のアダプター制御が含まれます。

combine_embeds

複数の embedding が存在する場合に、IPAdapter の embedding をどのように結合するかを制御します。

• concat – embedding を連結します。
• add – 要素ごとの加算を行います。
• subtract – 一方の embedding からもう一方を減算します。
• average – embedding の平均を取ります。
• norm average – 平均を取った後、結果を正規化します。
• max – 要素ごとの最大値を取ります。
• min – 要素ごとの最小値を取ります。

目的の結果に合う方法を選択してください。average と concat はスタイルや外観の混合によく使用され、add/subtract はより明示的な embedding 演算に役立ちます。

embeds_scaling

IPAdapter の embedding tensor がどのようにスケーリングされるかを制御します。

• V only – 視覚特徴のみを使用します。
• K+V – キーとバリューの両方の特徴を使用します。
• K+V w/ C penalty – クロスアテンション数のペナルティ付きでキーとバリューを使用します。
• K+mean(V) w/ C penalty – クロスアテンション数のペナルティ付きでキーと平均プールされたバリューを使用します。

デフォルトの V only は、ほとんどの IPAdapter モデルでスタンダードな選択肢です。他のモードは、特定の IPAdapter バリアントへの対応や高度なチューニングに使用できます。

cache_mode

連続する適用の間に何をキャッシュするかを制御します。

• insightface only（デフォルト）– insightface モデルのみをキャッシュします。顔関連の IPAdapter 使用に役立ちます。
• clip_vision only – CLIP vision の出力をキャッシュします。
• ipadapter only – 読み込まれた IPAdapter モデルをキャッシュします。
• all – 繰り返し実行時に最大の速度を得るためにすべてをキャッシュします。
• none – メモリを節約するためにキャッシュを無効化します。

同じアダプターを繰り返し使用する場合は、より高いキャッシュレベルを選択してください。メモリが限られている場合や、アダプター/プリセットが予測不能に変更される場合は none を使用してください。

optional_ipadapter

オプションの IPADAPTER 入力。接続すると、preset から読み込む代わりに、このプリロード済みの IPAdapter が使用されます。別のノードから IPAdapter をすでに読み込んでおり、再読み込みを避けたい場合に役立ちます。

image_negative

ネガティブな参照画像のためのオプションの IMAGE 入力。指定すると、ネガティブな IPAdapter embedding の構築に使用され、不要な特徴が結果に転写されるのを防ぐのに役立ちます。

出力

MODEL output

IPAdapter が適用された変更済みの diffusion モデル。これをサンプラーや他のモデル変更ノードに接続します。

IPADAPTER

使用された IPAdapter モデル/pipeline。これを他のノードに渡すことで、例えばアダプターの再読み込みを避けたり、さらなるアダプター操作を連結したりできます。

使用上の注意

• このノードは、すでに構築された IPADAPTER_PARAMS オブジェクトを想定しています。すべてのパラメータをノード上で直接設定する必要がある場合は、代わりに別の Easy Apply IPAdapter ノードを使用してください。
• preset と optional_ipadapter の入力は、アダプターを取得する 2 つの方法を提供します。自動読み込み用のプリセットを選択するか、既存の IPAdapter を接続して読み込みを完全にバイパスします。
• 同じプリセットで繰り返し生成を実行する場合は、cache_mode を all に保ち、毎回モデルを再読み込みしないようにします。アダプターを頻繁に切り替える場合は、insightface only または none を優先してください。
• embeds_scaling と combine_embeds は、使用する IPAdapter モデル/プリセットが想定する値と一致させる必要があります。設定が一致しない場合、結果が劣化する可能性があります。