Размытые лица и деформированные руки на сгенерированных изображениях — главная причина, по которой пользователи Stable Diffusion подключают расширение ADetailer (After Detailer). Этот плагин автоматически находит на картинке лица, руки и другие области, а затем дорабатывает их отдельным проходом инпейнтинга, не затрагивая остальную часть изображения.
Расширение работает поверх AUTOMATIC1111 WebUI и Forge, используя детекторы на базе моделей YOLO и MediaPipe. Ниже разберём установку, настройку, выбор моделей детекции и типичные ошибки, с которыми сталкиваются пользователи.
Что такое ADetailer и как он работает
ADetailer — это расширение для автоматической постобработки сгенерированных изображений. Принцип работы прост: после основной генерации детектор сканирует картинку, находит заданные объекты (лицо, руки, человека целиком), вырезает эти области и отправляет их на повторную генерацию с повышенным качеством.
Такой подход решает известную проблему диффузионных моделей: при генерации в низком разрешении мелкие элементы вроде глаз и пальцев получают слишком мало «внимания» модели. Детализация этих зон отдельным проходом даёт заметно более чистый результат без ручного инпейнтинга.
Установка расширения
Установка выполняется стандартным способом через интерфейс WebUI. Откройте вкладку Extensions, затем раздел Install from URL и вставьте ссылку на репозиторий расширения. После установки перезапустите WebUI полностью, а не только через кнопку перезагрузки интерфейса.
При первом запуске расширение автоматически скачает модели детекции в папку models/adetailer внутри директории WebUI. Для этого потребуется доступ к интернету — если загрузка не началась, проверьте соединение и лог консоли на наличие ошибок скачивания.
☑️ Проверка после установки ADetailer
Основные настройки и параметры
Панель ADetailer находится под основными параметрами генерации. Чтобы активировать обработку, поставьте галочку Enable ADetailer. Расширение поддерживает несколько последовательных проходов — например, первый для лица, второй для рук.
Ключевые параметры, которые стоит понимать:
- 🔍 ADetailer model — выбор детектора: face_yolov8n для лиц, hand_yolov8n для рук, person_yolov8n-seg для фигуры целиком
- 🎯 Detection confidence threshold — порог уверенности детектора; слишком низкое значение находит лишние области, слишком высокое пропускает нужные
- 🖌️ Denoising strength — сила перерисовки найденной области; умеренные значения сохраняют сходство с оригиналом
- 📐 Inpaint padding — отступ вокруг найденной области, влияет на плавность встраивания результата
⚠️ Внимание: слишком высокое значение Denoising strength в ADetailer может полностью изменить лицо персонажа. Начинайте с умеренных значений и повышайте постепенно, сверяясь с результатом.
Выбор модели детекции
Разные задачи требуют разных детекторов. Модели с суффиксом -seg используют сегментацию и точнее выделяют объект, но работают медленнее. Варианты без суффикса строят прямоугольную рамку и подходят для быстрой обработки.
| Модель | Назначение | Особенности |
|---|---|---|
| face_yolov8n | Лица | Быстрая, подходит для большинства портретов |
| hand_yolov8n | Руки | Исправляет деформированные пальцы |
| person_yolov8n-seg | Фигура человека | Сегментация всего тела |
| face_yolov8m | Лица | Точнее n-версии, но тяжелее |
| mediapipe_face | Лица | Альтернативный детектор на MediaPipe |
Если на изображении несколько людей, ADetailer обработает каждое найденное лицо по очереди. Это увеличивает время генерации пропорционально количеству объектов.
Типичные проблемы и их решения
Самая частая жалоба — ADetailer не срабатывает и не находит лица. Возможная причина: лицо на изображении слишком мелкое, повёрнуто в профиль или перекрыто объектами. Попробуйте снизить порог уверенности детектора или сменить модель на более чувствительную.
Вторая распространённая ситуация — ошибки при загрузке моделей детекции. Проверьте содержимое папки models/adetailer: если файлы отсутствуют или имеют нулевой размер, удалите их и перезапустите WebUI, чтобы загрузка повторилась. При блокировке скачивания файрволом или антивирусом добавьте исключение для папки WebUI.
Ошибка "No module named ultralytics" в консоли
Эта ошибка означает, что не установлена зависимость ultralytics. Обычно она ставится автоматически при первом запуске расширения. Если этого не произошло, откройте командную строку в папке WebUI с активированным виртуальным окружением и выполните установку пакета через pip, затем перезапустите интерфейс.
⚠️ Внимание: не скачивайте модели детекции со сторонних непроверенных источников. Используйте автоматическую загрузку расширения или официальный репозиторий проекта — поддельные файлы могут содержать вредоносный код.
Советы по эффективному использованию
Чтобы получить максимум от расширения, учитывайте несколько практических моментов:
- ⚡ Включайте ADetailer только когда он реально нужен — обработка увеличивает время генерации
- 🎭 Для аниме-стилей проверяйте результат внимательнее: детекторы обучены на реальных фото и могут хуже распознавать стилизованные лица
- 🔁 Используйте два прохода (лицо + руки) вместо одного общего — так контроль точнее
- 💾 Сохраняйте удачные пресеты настроек, чтобы не подбирать параметры заново
ADetailer позволяет задать отдельный промпт для дорабатываемой области — например, «detailed eyes, clear skin» только для лица. Это одна из самых недооценённых возможностей расширения: поле промпта находится внутри панели настроек каждого прохода.
Производительность и оптимизация
Каждый проход ADetailer — это дополнительная мини-генерация, поэтому время рендера растёт. На слабых видеокартах имеет смысл сократить количество шагов (steps) для инпейнтинга в настройках расширения: мелкие области не требуют стольких итераций, сколько полное изображение.
Также обратите внимание на параметр Inpaint only masked и размер области обработки. Слишком большая маска заставляет модель перерисовывать лишнее, слишком маленькая — обрезает контекст. Баланс подбирается экспериментально под конкретный тип изображений.
Часто задаваемые вопросы
Работает ли ADetailer с SDXL-моделями?
Да, расширение совместимо с SDXL, однако модели детекции остаются теми же, а качество результата зависит от разрешения исходной генерации. Убедитесь, что у вас актуальная версия расширения.
Почему ADetailer не появился в интерфейсе после установки?
Наиболее вероятная причина — WebUI не был полностью перезапущен. Закройте консоль и запустите webui-user.bat заново. Также проверьте, что расширение включено в списке на вкладке Extensions.
Можно ли использовать ADetailer в img2img?
Да, панель расширения доступна и во вкладке img2img. Это удобно для доработки уже готовых изображений, загруженных извне.
ADetailer обрабатывает не все лица на групповом изображении. Что делать?
Проверьте параметр максимального количества детекций в настройках расширения и снизьте порог уверенности детектора. Мелкие или частично скрытые лица могут распознаваться нестабильно — это ограничение детектора.
Влияет ли ADetailer на исходный seed и воспроизводимость?
Расширение использует параметры инпейнтинга отдельно от основной генерации. Для полной воспроизводимости сохраняйте все настройки ADetailer вместе с основным seed — удобно использовать встроенное сохранение параметров в PNG Info.