EasyUse/Adaptergenerated
Easy Apply IPAdapter(ipadapterApply)
Easy Apply IPAdapter ノード(ipadapterApply)は、IP-Adapter を Diffusion モデルにワンステップで適用します。
ipadapter Apply
model
image
attn_mask
optional_ipadapter
model
images
masks
ipadapter
preset
COMBO
lora_strength
0.60
provider
CUDA
weight
1.00
weight_faceidv2
1.00
start_at
0.000
end_at
1.000
cache_mode
all
use_tiled
Easy Use
説明
Easy Apply IPAdapter ノード(ipadapterApply)は、IP-Adapter を Diffusion モデルにワンステップで適用します。このノードは通常の IPAdapter パイプライン(プリセット選択、オプションの LoRA 強度、プロバイダー、スケジューリング、キャッシュ、オプションのアテンションマスク)をラップし、サンプラーに直接渡すことができる修正済みモデルを返します。
このノードは EasyUse/Adapter カテゴリに属します。
入力
| 名前 | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
model | MODEL | はい | — | IPAdapter を適用する Diffusion モデル。 |
image | IMAGE | はい | — | アダプターが使用する参照画像。FaceID プリセットの場合は、顔が写っている必要があります。 |
preset | COMBO | はい | — | 使用する IPAdapter プリセットを選択します。選択肢はインストール済みのプリセット/モデルによって異なります。 |
lora_strength | FLOAT | はい | 0.6 | 選択したプリセットで使用される LoRA の強度。LoRA を含まないプリセットではこの値は無視されます。 |
provider | COMBO | はい | CUDA | アダプターコンポーネントの実行プロバイダー。オプション: CPU、CUDA、ROCM、DirectML、OpenVINO、CoreML。 |
weight | FLOAT | はい | 1.0 | IPAdapter 全体の重み。範囲: -1 から 3、ステップ 0.05。0 に設定するとアダプターの影響を無効にします。 |
weight_faceidv2 | FLOAT | はい | 1.0 | 選択したプリセットが FaceID v2 の場合に使用される個別の重み。範囲: -1 から 5、ステップ 0.05。FaceID v2 以外のプリセットでは無視されます。 |
start_at | FLOAT | はい | 0.0 | IPAdapter の適用が開始されるステップの割合。範囲: 0 から 1、ステップ 0.001。 |
end_at | FLOAT | はい | 1.0 | IPAdapter の適用が終了するステップの割合。範囲: 0 から 1、ステップ 0.001。 |
cache_mode | COMBO | はい | all | 呼び出し間でキャッシュするコンポーネントを制御します。オプション: insightface only、clip_vision only、ipadapter only、all、none。 |
use_tiled | BOOLEAN | はい | false | タイル方式の IPAdapter 適用を有効にしてメモリ使用量を削減します。大きな画像に便利ですが、結果が若干異なる場合があります。 |
attn_mask | MASK | いいえ | — | IPAdapter のアテンションを制限するオプションのマスク。 |
optional_ipadapter | IPADAPTER | いいえ | — | プリセットから新しく構築する代わりに再利用する、既存の IPAdapter オブジェクト。 |
出力
| 型 | 説明 |
|---|---|
MODEL | IPAdapter が適用された入力モデル。アダプターを有効にして生成するには、これをサンプラーで使用します。 |
IMAGE | 変更されずにそのまま渡される、オリジナルの入力参照画像。 |
MASK | attn_mask に指定されたアテンションマスクをそのまま渡します。マスクが指定されていない場合は None。 |
IPADAPTER | このノードで作成または使用された IPAdapter オブジェクト。他のアダプターノードで再利用できます。 |
使用上の注意
- デフォルトのスケジューリング(
start_at=0.0、end_at=1.0)では、IPAdapter は denoising の全範囲で有効です。end_atを下げると初期のステップのみに適用され、start_atを上げると後半のみに適用されます。 weightはメインの強度コントロールです。weight_faceidv2は FaceID v2 プリセット用の追加の個別強度値です。lora_strengthは、選択したプリセットによって読み込まれる LoRA を制御します。FaceID スタイルのプリセットには通常このような LoRA が含まれますが、LoRA を含まないプリセットではこのパラメータは効果がありません。cache_modeはバッチ実行に便利です。allは再利用可能なすべてのコンポーネントをキャッシュし、noneはキャッシュを無効にしてリソースをより早く解放します。use_tiledは高解像度の画像でのメモリ不足エラーを回避するのに役立ちます。タイル処理はアテンションの挙動を変える可能性があるため、出力品質が重要な場合は結果を比較してください。IMAGEとMASKの出力は、チェーン接続用に提供されるパススルー値であり、生成済みの画像やマスクではありません。optional_ipadapterを指定すると、このノードは新しい IPAdapter を構築する代わりに、既に構築された IPAdapter を再利用できます。
コメント
GitHubでサインインしてディスカッションに参加しましょう。