Ошибка CUDA out of memory при генерации изображения в Stable Diffusion почти всегда означает, что видеокарте не хватило видеопамяти под выбранное разрешение и размер батча — и это лишь одна из десятков типичных проблем, с которыми сталкиваются пользователи нейросети. Сбои возникают на всех этапах: от установки AUTOMATIC1111 или ComfyUI до загрузки чекпоинтов и запуска генерации.
В этом материале разобраны самые распространённые ошибки Stable Diffusion: проблемы с видеопамятью, зависимостями Python, моделями, расширениями и веб-интерфейсом. Для каждой ситуации приведены безопасные шаги диагностики, которые не требуют переустановки системы или рискованных манипуляций. Начинайте с простых проверок — в большинстве случаев причина оказывается проще, чем кажется.
Ошибка CUDA out of memory: нехватка видеопамяти
Сообщение RuntimeError: CUDA out of memory появляется, когда генерация требует больше VRAM, чем физически доступно на видеокарте. Типичные триггеры — высокое разрешение изображения, большой размер батча, включённый Hires. fix или одновременно запущенные программы, потребляющие видеопамять (браузер с множеством вкладок, игры, другие нейросети).
Первое действие — снизить нагрузку. Уменьшите разрешение до 512×512, установите Batch size равным 1 и закройте лишние приложения. Если карта имеет мало видеопамяти, запустите веб-интерфейс с параметрами оптимизации. Для этого отредактируйте файл webui-user.bat, добавив в строку COMMANDLINE_ARGS нужные флаги:
set COMMANDLINE_ARGS=--medvram --xformers
Флаг --medvram снижает потребление памяти ценой скорости, а при совсем слабых картах используют --lowvram. Установка xformers дополнительно оптимизирует работу механизма внимания. Учтите, что поддержка конкретных флагов зависит от версии интерфейса — актуальный список смотрите в документации вашей сборки.
Ошибки при установке и запуске веб-интерфейса
Если webui-user.bat завершается с ошибкой сразу после запуска, чаще всего виноваты окружение и зависимости. Типичные симптомы: ModuleNotFoundError, сообщения о несовместимой версии Python или сбой при клонировании репозиториев через Git.
- 🐍 Проверьте версию Python командой
python --version— AUTOMATIC1111 традиционно требует Python 3.10.x, другие версии могут вызывать конфликты зависимостей. - 📁 Убедитесь, что путь к папке установки не содержит кириллицы и пробелов — это частая причина сбоев скриптов.
- 🌐 Проверьте доступность GitHub: обрыв сети при клонировании репозиториев приводит к неполной установке.
- 🔄 Удалите папку
venvвнутри каталога веб-интерфейса и запустите установку заново — виртуальное окружение пересоздастся с чистого листа.
Отдельная категория проблем — устаревший Git или его отсутствие в системной переменной PATH. Если установщик сообщает, что не может найти git, переустановите его с официального сайта и при установке отметьте опцию добавления в PATH.
⚠️ Внимание: не скачивайте «готовые сборки» Stable Diffusion с непроверенных ресурсов — в архивах могут быть подменённые скрипты. Используйте официальные репозитории проектов.
Проблемы с моделями и чекпоинтами
Модель скачана, помещена в models/Stable-diffusion, но не появляется в списке или выдаёт ошибку при загрузке. Возможных причин несколько, и проверять их стоит по порядку.
Во-первых, файл мог скачаться не полностью — прерванная загрузка даёт битый чекпоинт, который не загружается. Сравните размер файла с указанным на странице источника. Во-вторых, формат .safetensors предпочтительнее .ckpt: файлы ckpt исполняют код при загрузке, что и менее безопасно, и чаще вызывает конфликты. В-третьих, модели для SDXL и SD 1.5 несовместимы между собой — чекпоинт одной архитектуры не заработает с настройками другой.
Где искать лог ошибок
Полный текст ошибки выводится в консоль (чёрное окно командной строки), которое открывается вместе с веб-интерфейсом. Ищите последний блок, начинающийся со слова Traceback, — именно последняя строка этого блока содержит суть проблемы.
Если модель загружается, но генерация обрывается на середине, проверьте свободное место на диске и стабильность ОЗУ. Большие чекпоинты при подгрузке могут занимать заметный объём оперативной памяти, особенно в связке с флагом --lowvram, который переносит часть данных с видеокарты в RAM.
Чёрные, зелёные или искажённые изображения
Чёрный квадрат вместо результата — узнаваемый симптом. Одна из возможных причин — срабатывание встроенного фильтра NSFW, который заменяет изображение чёрным полем. Другая частая причина — численная нестабильность при работе в половинной точности (fp16) на некоторых видеокартах, особенно старых моделях.
Попробуйте запустить интерфейс с параметрами --no-half --precision full — генерация станет медленнее и прожорливее по памяти, но исключит ошибки вычислений. Также проверьте значения CFG Scale и числа шагов: экстремально высокие значения иногда приводят к «пережжённым» или разваленным картинкам. Если изображения искажены только при использовании VAE из комплекта чекпоинта, скачайте внешний VAE-файл или переключитесь на встроенный (Automatic) в настройках.
☑️ Диагностика чёрных изображений
Ошибки расширений и конфликты версий
Расширения для AUTOMATIC1111 — частый источник сбоев после обновления самого интерфейса. Симптомы: веб-UI не стартует, выдаёт ImportError или отдельные вкладки перестают работать.
Действуйте методом исключения. Переименуйте папку extensions, запустите интерфейс в чистом виде — если всё работает, возвращайте расширения по одному, пока не найдёте проблемное. Альтернатива — флаг --disable-all-extensions, если он поддерживается вашей версией. После обновления веб-интерфейса через git pull всегда проверяйте совместимость установленных дополнений.
| Ошибка | Вероятная причина | Первое действие |
|---|---|---|
| CUDA out of memory | Не хватает VRAM | Снизить разрешение и batch size |
| ModuleNotFoundError | Битое окружение или версия Python | Пересоздать папку venv |
| Модель не появляется в списке | Недокачанный файл или неверная папка | Сверить размер файла и путь |
| Чёрное изображение | NSFW-фильтр или ошибки fp16 | Флаг --no-half, смена VAE |
| ImportError после обновления | Несовместимое расширение | Отключить расширения и включать по одному |
⚠️ Внимание: не обновляйте веб-интерфейс и все расширения одновременно — при сбое будет невозможно понять, что именно сломало систему. Обновляйте по очереди и проверяйте работоспособность после каждого шага.
Медленная генерация и ошибки драйверов
Генерация занимает минуты вместо секунд? Проверьте, действительно ли используется видеокарта. Сообщение вида running on CPU в консоли означает, что PyTorch не видит GPU — обычно из-за отсутствия CUDA-совместимой версии библиотеки или устаревшего драйвера NVIDIA.
Обновите драйвер видеокарты с официального сайта производителя. Если это не помогло, вероятно, установлена CPU-сборка PyTorch — её нужно переустановить с индексом CUDA по инструкции с официального сайта PyTorch, выбрав конфигурацию под вашу систему. Точные команды зависят от версии, поэтому копируйте их из официального установщика, а не из сторонних статей.
Часто задаваемые вопросы
Stable Diffusion запускается, но выдаёт ошибку при первой генерации. Что делать?
Откройте консоль и найдите последний блок Traceback — последняя строка укажет суть ошибки. Чаще всего это нехватка видеопамяти или недокачанная модель. Попробуйте сгенерировать изображение 512×512 с batch size 1.
Подойдёт ли видеокарта AMD для Stable Diffusion?
Да, но поддержка отличается. На Windows чаще используют сборки с DirectML, на Linux — ROCm. Производительность и совместимость зависят от конкретной карты и версии драйверов, поэтому сверяйтесь с документацией выбранного интерфейса.
Ошибка "git is not installed" при запуске установщика — как исправить?
Установите Git с официального сайта git-scm.com и при установке выберите опцию добавления в PATH. После этого перезапустите командную строку и повторите установку.
Можно ли запускать Stable Diffusion на карте с 4 ГБ видеопамяти?
Можно, с флагами --lowvram и --medvram, на разрешении 512×512. Генерация будет медленнее, и часть функций (например, обучение или крупные батчи) окажется недоступной.
После обновления веб-интерфейс перестал запускаться. Как откатиться?
Если установка выполнена через Git, можно вернуться к предыдущему коммиту командой git checkout с указанием хеша рабочей версии. Также проверьте расширения — именно они чаще всего ломаются после обновлений.