Easy Apply IPAdapter（埋め込み）(ipadapterApplyEmbeds)

Easy Apply IPAdapter（埋め込み） ノード（クラス ipadapterApplyEmbeds）は、参照画像の代わりに事前計算されたembeddingを使用して、diffusionモデルにIP-Adapterを適用します。エンコーダーやembedding生成ノードから既に EMBEDS を取得しているワークフロー向けで、IPAdapterの主要コントロールをコンパクトな「Easy Apply」インターフェースで提供します。このノードは、サンプラーに渡す準備が整ったパッチ適用済みの MODEL と、さらなるアダプターステップをチェーンするための IPADAPTER 出力を返します。EasyUse/Adapter カテゴリにあります。

入力

必須

• model（MODEL）
  IP-Adapterが適用されるベースのdiffusionモデル。

• clip_vision（CLIP_VISION）
  読み込まれたCLIP Visionモデル。このノードは事前計算されたembeddingを使用しますが、IPAdapterパイプラインは内部でCLIP Visionモデルを必要とします。embeddingの生成時に使用したものと同じCLIP Visionモデルを接続してください。

• ipadapter（IPADAPTER）
  適用するIPAdapterモデル/設定。

• pos_embed（EMBEDS）
  転送するスタイル、コンテンツ、または被写体を記述するポジティブembedding。アダプターの主な条件付けソースです。

• weight（FLOAT、デフォルト = 1、範囲 = -1〜3）
  IPAdapterの全体的な強さ。値を低くすると効果が弱まり、高くすると効果が強まります。0にするとアダプターは実質的に無効になります。

• weight_type（COMBO）
  IPAdapterのウェイト設定プリセットを選択します。プリセットによって、アダプターのアテンションがプロンプトとどのようにブレンドされるかが変わり、スタイル転送、構図、プロンプトへの忠実度の間でトレードオフを調整できます。正確なプリセット名はIPAdapterの実装によって提供されます。

• start_at（FLOAT、デフォルト = 0、範囲 = 0〜1）
  IPAdapterの適用を開始するdenoise処理の割合。生成の最初から適用する場合は0のままにします。

• end_at（FLOAT、デフォルト = 1、範囲 = 0〜1）
  IPAdapterの適用を停止するdenoise処理の割合。生成の最後まで適用する場合は1のままにします。

• embeds_scaling（COMBO）
  事前計算されたembeddingがクロスアテンション内でどのように使用されるかを制御します。利用可能なオプション：

  • V only：embeddingのバリュー（値）コンポーネントのみを注入します。
  • K+V：embeddingのキーとバリューの両方のコンポーネントを注入します。
  • K+V w/ C penalty：K+Vと同じですが、追加のクロスアテンションペナルティが適用されます。
  • K+mean(V) w/ C penalty：キーと平均プールされたバリューベクトルを使用し、同じクロスアテンションペナルティが適用されます。

オプション

• neg_embed（EMBEDS、オプション）
  不要なスタイルやコンテンツから結果を遠ざけるために使用するネガティブembedding。利用可能なネガティブembeddingがない場合は、未接続のままにしてください。

• attn_mask（MASK、オプション）
  IPAdapterの影響を生成済み画像の特定領域に制限するオプションのアテンションマスク。アダプターを全体に適用する場合は未接続のままにしてください。

出力

• MODEL
  IPAdapterがパッチ適用されたdiffusionモデル。これをサンプラーまたは他のモデル処理ノードに渡します。

• IPADAPTER
  使用されたIPAdapterオブジェクト。単一のワークフローで複数のアダプターをスタックする場合、別のEasy Apply IPAdapterノードに渡すことができます。

使用上の注意

• このノードは画像入力を受け付けません。参照画像がある場合は、代わりに通常のEasy Apply IPAdapterノードを使用してください。前のIPAdapterエンコードステップから既に EMBEDS を取得している場合は、このノードを使用します。
• pos_embed は必須で、neg_embed はオプションです。embeddingが1つしかない場合は、neg_embed を未接続のままにしてください。
• start_at と end_at を使用して、サンプリングスケジュールのどこでアダプターを有効にするかを制御します。例えば、生成の途中でのみIPAdapterを適用すると、スタイルを転送しながら全体的な構図を維持するのに役立ちます。
• IPADAPTER 出力はチェーンに役立ちます。1つのEasy Apply IPAdapterノードの MODEL 出力を取得して別のノードの model 入力に渡し、IPADAPTER 出力を通じて同じアダプター設定を再利用します。