Stable Diffusion WebUI 配置
Stable Diffusion WebUI 常用于本地图片生成。它和聊天工具不同：你主要配置模型文件、采样器、尺寸、步数和提示词。如果要给其他工具调用，需要先开启 API。
官方信息 下载和文档以官方站点为准
开启 API
| 配置项 | 填写方式 |
|---|---|
| 启动参数 | --api |
| 网页地址 | http://127.0.0.1:7860 |
| 接口文档 | http://127.0.0.1:7860/docs |
| 文生图接口 | /sdapi/v1/txt2img |
WebUI 界面参考 这张图用于确认主界面形态。API 是否可用，要看启动时是否加了 --api，并能否打开 /docs。
- 安装并启动 Stable Diffusion WebUI。
- 如果你要让脚本调用它，启动时加上
--api。 - 打开
http://127.0.0.1:7860/docs，确认接口文档能打开。 - 先在网页里成功出一张图，再用 API 测试。
- 如果报错，优先检查模型文件、显存、采样器名称和图片尺寸。
出图参数怎么理解
| 字段 | 含义 | 新手建议 |
|---|---|---|
| prompt | 正向提示词 | 写你希望画面里出现什么 |
| negative_prompt | 反向提示词 | 写你不希望出现什么 |
| steps | 采样步数 | 先用 20 到 30，不要一开始拉很高 |
| width / height | 图片尺寸 | 先用 512 或 768 级别，显存不够就降低 |
| 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，或填网页里当前能成功的采样器 |
| 显存不足 | width、height、steps、批量数量 | 先用 512x512、20 步测试，再逐步提高 |