Easy Apply InstantID: ComfyUI-Easy-UseのInstantID適用ノード(instantIDApply)

このノードは、EasyUseパイプライン内でInstantIDのアイデンティティ保持を適用します。顔画像、選択済みのInstantIDモデル、オプションのControlNet、InsightFaceベースの顔分析を使用して、モデルにアイデンティティ情報を注入し、サンプリングに適したポジティブ/ネガティブ条件付けを生成します。

入力

必須

• pipe（PIPE_LINE）: モデル、条件付け、その他のサンプリングデータを含むパイプラインの状態です。このノードは、InstantIDアダプターを適用した状態でこのパイプラインを更新します。
• image（IMAGE）: InstantIDのアイデンティティembeddingを抽出するために使用される顔画像です。
• instantid_file（COMBO）: 利用可能なファイルから使用するInstantIDモデルファイルを選択します。
• insightface（COMBO）: InsightFaceの顔分析に使用するデバイスバックエンドです。オプション: CPU、CUDA、ROCM。お使いのハードウェアに合ったバックエンドを選択してください。
• control_net_name（COMBO）: InstantIDと併用して構造/ポーズのガイダンスに使用するControlNetモデルファイルを選択します。
• cn_strength（FLOAT）: 適用されるControlNetの強さです。デフォルトは1.0、範囲は0.0から10.0です。
• cn_soft_weights（FLOAT）: ControlNetの寄与に対するソフトウェイトです。デフォルトは1.0、範囲は0.0から1.0です。
• weight（FLOAT）: InstantIDアイデンティティアダプターの全体的な強さです。デフォルトは0.8、範囲は0.0から5.0です。
• start_at（FLOAT）: InstantID/ControlNetの条件付けが効果を発揮し始めるデノイズ処理の割合です。デフォルトは0.0、範囲は0.0から1.0です。
• end_at（FLOAT）: InstantID/ControlNetの条件付けの効果が終了するデノイズ処理の割合です。デフォルトは1.0、範囲は0.0から1.0です。
• noise（FLOAT）: 条件付け/アイデンティティembeddingに適用されるノイズの量です。デフォルトは0.35、範囲は0.0から1.0、ステップは0.05です。

オプション

• image_kps（IMAGE）: 構造ガイダンス用のControlNetキーポイント入力として使用されるオプションのキーポイント/ポーズ画像です。
• mask（MASK）: InstantIDの効果を画像の特定領域に制限するオプションのマスクです。
• control_net（CONTROL_NET）: オプションのプリロード済みControlNetモデルです。指定すると、control_net_nameで選択されたモデルを上書きできます。

出力

• PIPE_LINE: InstantIDの条件付けが適用された更新済みのパイプライン状態です。
• MODEL: InstantIDアダプターとControlNetが適用されたパッチ適用済みモデルです。
• CONDITIONING: InstantIDのアイデンティティ情報を含むポジティブ条件付けです。
• CONDITIONING: サンプリング中に使用するネガティブ条件付けです。

使用上の注意

• 返されたモデルでサンプリングする際は、ポジティブおよびネガティブ条件付けの出力を使用してください。
• imageは、信頼性の高いアイデンティティ抽出のために、鮮明な顔画像である必要があります。
• image_kpsを指定すると、アイデンティティ画像とは別にポーズ/構造情報を転送するために使用できます。
• start_atとend_atの値を使用すると、デノイズ中にInstantID/ControlNetガイダンスがアクティブになるタイミングを制御でき、アイデンティティの忠実度と全体的な構図のバランスを取るのに役立ちます。
• 正しいinsightfaceバックエンドを選択することは、パフォーマンスと互換性にとって重要です。GPUアクセラレーションが利用可能な場合はCUDAまたはROCMを、フォールバックとしてCPUを使用してください。