Настройка Stable Diffusion WebUI
Stable Diffusion WebUI обычно используется для локальной генерации изображений. В отличие от чат-инструментов, здесь в основном настраиваются файлы моделей, сэмплер, размер, шаги и промпты. Если вы хотите, чтобы другие инструменты вызывали его, сначала необходимо включить API.
Официальная информация Загрузки и документация актуальны на официальном сайте.
Включение API
| Параметр конфигурации | Способ заполнения |
|---|---|
| Параметры запуска | --api |
| Веб-адрес | http://127.0.0.1:7860 |
| Документация API | http://127.0.0.1:7860/docs |
| API генерации по тексту (Text-to-image) | /sdapi/v1/txt2img |
Справка по интерфейсу WebUI Это изображение используется для подтверждения основного макета интерфейса. Доступность API зависит от того, был ли добавлен флаг --api при запуске и открывается ли страница /docs.
- Установите и запустите Stable Diffusion WebUI.
- Если вы хотите вызывать его из скриптов, добавьте при запуске параметр
--api. - Откройте
http://127.0.0.1:7860/docsи убедитесь, что документация API открывается. - Сначала успешно сгенерируйте изображение в веб-интерфейсе, а затем протестируйте через API.
- При возникновении ошибок сначала проверьте файлы моделей, видеопамять, имя сэмплера и размер изображения.
Понимание параметров генерации изображений
| Параметр | Значение | Советы для начинающих |
|---|---|---|
| prompt | Положительные промпты | Опишите то, что должно появиться на изображении |
| negative_prompt | Отрицательные промпты | Опишите то, чего на изображении быть не должно |
| steps | Шаги сэмплирования | Начните с 20–30 шагов, не устанавливайте сразу слишком большое значение |
| width / height | Размер изображения | Начните с уровня 512 или 768, уменьшите при нехватке видеопамяти (VRAM) |
| sampler_name | Сэмплер | Начните со значения по умолчанию или с сэмплера, работающего в веб-интерфейсе |
Пример API
Минимальный запрос для генерации по тексту в SD WebUI
curl -X POST http://127.0.0.1:7860/sdapi/v1/txt2img \ -H "Content-Type: application/json" \ -d '{ "prompt": "a clean product photo of a white ceramic cup", "negative_prompt": "blurry, low quality", "steps": 20, "width": 512, "height": 512 }'Часто задаваемые вопросы для начинающих
| Проблема | Что проверить в первую очередь | Решение |
|---|---|---|
/docs не открывается | Был ли добавлен при запуске флаг --api | Перезапустите WebUI и убедитесь в отсутствии ошибок в консоли |
| Генерация работает в веб-интерфейсе, но не через API | Правильный ли адрес API: /sdapi/v1/txt2img | Сначала протестируйте с минимальным запросом, не добавляйте слишком много параметров сразу |
| Ошибка сэмплера | Существует ли указанный sampler_name | Попробуйте не указывать sampler_name или используйте сэмплер, который сейчас работает в веб-интерфейсе |
| Недостаточно видеопамяти | Ширина, высота, количество шагов, размер пакета | Начните с 512x512 и 20 шагов, затем постепенно увеличивайте параметры |