sd-webui-controlnet - Stable Diffusion WebUIのControlNet拡張機能

sd-webui-controlnet プロジェクト詳細

プロジェクト概要

sd-webui-controlnet は、AUTOMATIC1111 の Stable Diffusion WebUI 用に開発された ControlNet 拡張プラグインです。Mikubill によってメンテナンスされており、現在最も人気があり、機能が充実した ControlNet WebUI 拡張の一つです。

プロジェクト情報

プロジェクトアドレス: https://github.com/Mikubill/sd-webui-controlnet
主要メンテナンス担当者: Mikubill
プロジェクトタイプ: WebUI 拡張プラグイン

コア機能

1. ControlNet 統合

ControlNet 1.0 および 1.1 バージョンを完全にサポート
ControlNet を元の Stable Diffusion モデルに即座に追加、マージ不要
多様な制御モデルタイプをサポート

2. プリプロセッササポート

多様な画像プリプロセッサをサポート：

Canny: エッジ検出
Depth: 深度マップ生成 (Midas, Depth Anything V2 を含む)
OpenPose: 人体姿勢検出
Scribble: 落書き制御
Segmentation: 画像セグメンテーション
Normal: 法線マップ
Lineart: 線画抽出
MLSD: 直線検出
HED: ホログラフィックネスト化エッジ検出
Reference-only: 参照画像モード

3. 高度な機能

複数 ControlNet サポート

一度の生成で複数の ControlNet 入力を同時に使用可能
設定で最大モデル数を調整可能

制御モード

バランスモード: ControlNet は CFG スケールの両側で動作
プロンプトがより重要: ControlNet の影響を徐々に減少
ControlNet がより重要: CFG の条件側のみで動作

ピクセルパーフェクトモード

最適なプリプロセッサ解像度を自動計算
各ピクセルが Stable Diffusion と完全に一致することを保証

4. T2I-Adapter サポート

TencentARC の T2I-Adapter モデルを完全にサポート：

Color Adapter
Style Adapter
Sketch Adapter
Depth Adapter

5. IP-Adapter 機能

画像プロンプトアダプター
CLIP マスクサポート
IP-Adapter 自動プリプロセッサ
高度な重み制御

技術特性

スマート画像リサンプリング

高解像度修復時に 2 つの制御画像を出力
小さい画像は基本生成に使用、大きい画像は高解像度修復に使用
スマートアルゴリズムにより高品質な制御画像リサンプリングを保証

マスク統合

A1111 の様々なマスクタイプを完璧にサポート
"Inpaint masked"/"Inpaint not masked" をサポート
"Whole picture"/"Only masked" をサポート
A1111 のサイズ調整オプションと完璧に一致

バッチ処理モード

画像のバッチ処理をサポート
各ユニットにバッチ処理ディレクトリを指定
txt2img および img2img タブで使用可能

インストール方法

WebUI 経由でのインストール

"Extensions" タブを開く
"Install from URL" サブタブを開く
"URL for extension's git repository" に以下を入力：
```
https://github.com/Mikubill/sd-webui-controlnet.git
```
"Install" ボタンをクリック
インストール完了後、WebUI を再起動

モデルダウンロード

公式モデルダウンロードページにアクセス：https://github.com/Mikubill/sd-webui-controlnet/wiki/Model-download
モデルファイルを stable-diffusion-webui\extensions\sd-webui-controlnet\models ディレクトリに配置

API サポート

REST API

WebUI 起動時に --api パラメータを使用
http://webui-address/docs にアクセスして API ドキュメントを参照
txt2img および img2img タスクをサポート

外部呼び出し

他のスクリプトによるこの拡張の制御をサポート
設定で "Allow other scripts to control this extension" を有効にする必要あり

コマンドラインパラメータ

拡張機能は以下のコマンドラインパラメータを追加します：

--controlnet-dir <path>                           # ControlNet モデルディレクトリを追加
--controlnet-annotator-models-path <path>        # プリプロセッサモデルディレクトリを設定
--no-half-controlnet                             # ControlNet モデルを全精度でロード
--controlnet-preprocessor-cache-size             # プリプロセッサ結果キャッシュサイズ
--controlnet-loglevel                            # ControlNet 拡張ログレベル
--controlnet-tracemalloc                         # メモリ割り当て追跡を有効化

システム要件

最低構成

Windows/Linux/macOS
NVIDIA GPU (4GB+ VRAM 推奨)
Python 3.8+
AUTOMATIC1111 WebUI

パフォーマンス最適化

--xformers パラメータを使用してパフォーマンスを向上
低 VRAM デバイスには "Low VRAM" モードを有効化
最大 768x832 解像度をサポート (4GB VRAM)

使用例

基本的な使用

WebUI で ControlNet を有効にする
プリプロセッサタイプを選択（Canny、Depth など）
制御画像をアップロードするか、プリプロセッサに自動生成させる
重みとガイダンス強度を調整
画像を生成

複数 ControlNet の使用

設定で最大モデル数を増やす
複数の ControlNet ユニットを同時に有効にする
各ユニットに異なるプリプロセッサと重みを設定
複数の制御条件を組み合わせて画像を生成

まとめ

sd-webui-controlnet は Stable Diffusion エコシステムにおいて最も重要な拡張機能の一つであり、AI 画像生成の制御性と精度を大幅に拡張します。プロのアーティストからアマチュアまで、この拡張機能を通じてより正確な画像制御とより豊かな創作の可能性を実現できます。