【深度学习】stable-diffusion-webui AUTOMATIC1111 的参数解释翻译

https://github.com/AUTOMATIC1111/stable-diffusion-webui/wiki/Command-Line-Arguments-and-Settings

参数命令值默认值描述 -h, --help None False 显示帮助信息并退出 –exit 安装后终止 –data-dir DATA_DIR ./ 存储所有用户数据的基本路径 –config CONFIG configs/stable-diffusion/v1-inference.yaml 构建模型的配置文件路径 –ckpt CKPT model.ckpt 稳定扩散模型的检查点路径；如果指定，则将此检查点添加到检查点列表并加载 –ckpt-dir CKPT_DIR None 稳定扩散检查点目录路径 –no-download-sd-model None False 即使未找到模型也不下载SD1.5模型 –do-not-download-clip None False 即使检查点中不包含CLIP模型也不下载 –vae-dir VAE_PATH None 变分自编码器模型路径 –vae-path VAE_PATH None 用作VAE的检查点；设置此参数 –gfpgan-dir GFPGAN_DIR GFPGAN/ GFPGAN目录 –gfpgan-model GFPGAN_MODEL GFPGAN model file name. –codeformer-models-path CODEFORMER_MODELS_PATH models/Codeformer/ codeformer模型文件的目录路径 –gfpgan-models-path GFPGAN_MODELS_PATH models/GFPGAN GFPGAN模型文件的目录路径 –esrgan-models-path ESRGAN_MODELS_PATH models/ESRGAN ESRGAN模型文件的目录路径 –bsrgan-models-path BSRGAN_MODELS_PATH models/BSRGAN BSRGAN模型文件的目录路径 –realesrgan-models-path REALESRGAN_MODELS_PATH models/RealESRGAN RealESRGAN模型文件的目录路径 –scunet-models-path SCUNET_MODELS_PATH models/ScuNET ScuNET模型文件的目录路径 –swinir-models-path SWINIR_MODELS_PATH models/SwinIR SwinIR和SwinIR v2模型文件的目录路径 –ldsr-models-path LDSR_MODELS_PATH models/LDSR LDSR模型文件的目录路径 –dat-models-path DAT__MODELS_PATH models/DAT DAT模型文件的目录路径 –lora-dir LORA_DIR models/Lora Lora网络目录路径 –clip-models-path CLIP_MODELS_PATH None CLIP模型文件的目录路径 –embeddings-dir EMBEDDINGS_DIR embeddings/ 文本反演的嵌入目录（默认：embeddings） –textual-inversion-templates-dir TEXTUAL_INVERSION_TEMPLATES_DIR textual_inversion_templates 文本反演模板目录 –hypernetwork-dir HYPERNETWORK_DIR models/hypernetworks/ 超网络目录 –localizations-dir LOCALIZATIONS_DIR localizations/ 本地化目录 –styles-file STYLES_FILE styles.csv 样式文件路径或通配符路径，允许多个条目 –ui-config-file UI_CONFIG_FILE ui-config.json 用于UI配置的文件名 –no-progressbar-hiding None False 在gradio UI中不隐藏进度条（我们隐藏它是因为如果浏览器中有硬件加速会减慢ML速度） –max-batch-count MAX_BATCH_COUNT 16 UI的最大批次计数值 –ui-settings-file UI_SETTINGS_FILE config.json 用于UI设置的文件名 –allow-code None False 允许从Web UI执行自定义脚本 –share None False 对gradio使用share=True并使UI通过其网站访问 –listen None False 使用0.0.0.0作为服务器名称启动gradio，允许响应网络请求 –port PORT 7860 使用给定的服务器端口启动gradio，您需要root/admin权限来使用端口<1024；如果可用，默认为7860 –hide-ui-dir-config None False 在Web UI中隐藏目录配置 –freeze-settings None False 全局禁用所有设置的编辑 –freeze-settings-in-sections None False 通过指定逗号分隔的列表，如"saving-images,upscaling"，在设置页面的特定部分禁用设置编辑 –freeze-specific-settings None False 通过指定逗号分隔的列表，如"samples_save,samples_format"，禁用单个设置的编辑 –enable-insecure-extension-access None False 无论其他选项如何，启用扩展选项卡 –gradio-debug None False 使用–debug选项启动gradio –gradio-auth GRADIO_AUTH None 设置gradio身份验证，如username:password；或用逗号分隔多个，如u1:p1,u2:p2,u3:p3 –gradio-auth-path GRADIO_AUTH_PATH None 设置gradio身份验证文件路径，如/path/to/auth/file，身份验证格式与–gradio-auth相同 –disable-console-progressbars None False 不向控制台输出进度条 –enable-console-prompts None False 在使用txt2img和img2img生成时将提示输出到控制台 –api None False 使用API启动Web UI –api-auth API_AUTH None 为API设置身份验证，如username:password；或用逗号分隔多个，如u1:p1,u2:p2,u3:p3 –api-log None False 启用所有API请求的日志记录 –nowebui None False 仅启动API，而不启动UI –ui-debug-mode None False 不加载模型以快速启动UI –device-id DEVICE_ID None 选择要使用的默认CUDA设备（可能需要在之前导出CUDA_VISIBLE_DEVICES=0,1等） –administrator None False 管理员权限 –cors-allow-origins CORS_ALLOW_ORIGINS None 允许的CORS源，以逗号分隔的列表形式（无空格） –cors-allow-origins-regex CORS_ALLOW_ORIGINS_REGEX None 允许的CORS源，以单个正则表达式的形式 –tls-keyfile TLS_KEYFILE None 部分启用TLS，需要–tls-certfile才能完全功能 –tls-certfile TLS_CERTFILE None 部分启用TLS，需要–tls-keyfile才能完全功能 –disable-tls-verify None False 传递时，启用使用自签名证书 –server-name SERVER_NAME None 设置服务器的主机名 –no-gradio-queue None False 禁用gradio队列；使网页使用http请求而不是websockets；在早期版本中是默认设置 –gradio-allowed-path None None 将路径添加到Gradio的allowed_paths；使其能够从中提供文件 –no-hashing None False 禁用检查点的SHA-256哈希以帮助加载性能 –skip-version-check None False 不检查torch和xformers的版本 –skip-python-version-check None False 不检查Python版本 –skip-torch-cuda-test None False 不检查CUDA是否能正常工作 –skip-install None False 跳过软件包的安装 –loglevel None None 日志级别；其中之一：CRITICAL，ERROR，WARNING，INFO，DEBUG –log-startup None False launch.py参数：在启动时打印详细日志 –api-server-stop None False 启用通过api停止/重新启动/终止服务器 –timeout-keep-alive int 30 设置uvicorn的timeout_keep_alive 性能 –xformers None False 为交叉注意层启用xformers –force-enable-xformers None False 启用xformers为交叉注意层，即使检查代码认为您可以运行它；如果这不起作用，请不要报告错误 –xformers-flash-attention None False 启用xformers与Flash Attention以提高可重复性（仅支持SD2.x或变体） –opt-sdp-attention None False 启用缩放点积交叉注意层优化；需要PyTorch 2.* –opt-sdp-no-mem-attention False None 启用缩放点积交叉注意层优化，而不使用内存高效注意力，使图像生成确定性；需要PyTorch 2.* –opt-split-attention None False 强制启用Doggettx的交叉注意层优化。默认情况下，CUDA启用系统时启用 –opt-split-attention-invokeai None False 强制启用InvokeAI的交叉注意层优化。默认情况下，当CUDA不可用时启用 –opt-split-attention-v1 None False 启用不占用所有可用VRAM的旧版本拆分注意优化 –opt-sub-quad-attention None False 启用内存高效的次二次方交叉注意层优化 –sub-quad-q-chunk-size SUB_QUAD_Q_CHUNK_SIZE 1024 次二次方交叉注意层优化使用的查询块大小 –sub-quad-kv-chunk-size SUB_QUAD_KV_CHUNK_SIZE None 次二次方交叉注意层优化使用的KV块大小 –sub-quad-chunk-threshold SUB_QUAD_CHUNK_THRESHOLD None 次二次方交叉注意层优化使用分块的VRAM阈值百分比 –opt-channelslast None False 为4d张量启用备用布局，可能仅在具有Tensor核心（16xx及更高版本）的Nvidia卡上实现更快的推理 –disable-opt-split-attention None False 强制禁用交叉注意层优化 –disable-nan-check None False 不检查生成的图像/潜在空间是否有nans；对于在CI中不带检查点运行很有用 –use-cpu {all, sd, interrogate, gfpgan, bsrgan, esrgan, scunet, codeformer} None 对指定模块使用CPU作为torch设备 –use-ipex None False 使用Intel XPU作为torch设备 –no-half None False 不将模型切换到16位浮点数 –precision {full,autocast} autocast 以此精度进行评估 –no-half-vae None False 不将VAE模型切换到16位浮点数 –upcast-sampling None False 上采样。对–no-half没有影响。通常会产生与–no-half相似的结果，但性能更好，同时使用更少的内存。 –medvram None False 启用稳定扩散模型优化以牺牲一些性能换取低VRAM使用 –medvram-sdxl None False 仅对SDXL模型启用–medvram优化 –lowvram None False 启用稳定扩散模型优化以牺牲大量速度换取非常低的VRAM使用 –lowram None False 将稳定扩散检查点权重加载到VRAM而不是RAM –disable-model-loading-ram-optimization None False 禁用在加载模型时减少RAM使用的优化特性 –autolaunch None False 启动时在系统默认浏览器中打开Web UI URL –theme None Unset 使用指定的主题（light或dark）打开Web UI。如果未指定，则使用默认浏览器主题 –use-textbox-seed None False 在UI中使用文本框作为种子（没有上下，但可以输入长种子） –disable-safe-unpickle None False 禁用检查PyTorch模型中的恶意代码 –ngrok NGROK None ngrok身份令牌，是gradio–share的替代方案 –ngrok-region NGROK_REGION us ngrok应启动的区域 –ngrok-options NGROK_OPTIONS None 传递给ngrok的选项，格式为JSON，例如：

{“authtoken_from_env”:true, “basic_auth”:“user:password”, “oauth_provider”:“google”, “oauth_allow_emails”:“user@asdf.com”}

–update-check None None 启动时通知您的Web UI版本（提交）是否与当前主分支同步 –update-all-extensions None None 启动时，拉取所有已安装扩展的最新更新 –reinstall-xformers None False 强制重新安装xformers。对升级有用-但升级后请将其删除，否则您将永远重新安装xformers –reinstall-torch None False 强制重新安装torch。对升级有用-但升级后请将其删除，否则您将永远重新安装torch –tests TESTS False 运行测试以验证Web UI功能，详见wiki主题 –no-tests None False 即使指定了–tests选项，也不要运行测试 –dump-sysinfo None False launch.py参数：转储有限的系统信息文件（不包含有关扩展，选项的信息）到磁盘并退出 –disable-all-extensions None False 禁用所有非内置扩展的运行 –disable-extra-extensions None False 禁用所有扩展的运行 –skip-load-model-at-start None False 如果在Web启动时加载模型，仅在–nowebui时生效 –unix-filenames-sanitization None False 允许文件名中除’/'之外的任何符号。可能与您的浏览器和文件系统冲突 –filenames-max-length int 128 保存图像的文件名最大长度，较长的文件名将被截断。如果被覆盖，可能会导致文件系统问题 –no-prompt-history None False 禁用从上次生成的提示读取功能；禁用–data-path/params.txt 废弃选项 –show-negative-prompt None False 不再有效 –deepdanbooru None False 不再有效 –unload-gfpgan None False 不再有效 –gradio-img2img-tool GRADIO_IMG2IMG_TOOL None 不再有效 –gradio-inpaint-tool GRADIO_INPAINT_TOOL None 不再有效 –gradio-queue None False 不再有效 –add-stop-route None False 不再有效 –always-batch-cond-uncond None False 不再有效，移至UI下的设置>优化

总结

**文章总结：《stable-diffusion-webui参数与设置》**
**一、简介**
文章全面介绍了`stable-diffusion-webui`的命令行参数（Command-Line Arguments）和设置选项，这些选项在配置Stable Diffusion Web界面时至关重要。
**二、主要参数与设置**
**1. **基本设置****:
- 数据目录（--data-dir）、配置文件（--config）、模型检查点（--ckpt）等基础文件的路径设置。
- 包含是否下载缺失模型的选项（如--no-download-sd-model）。
- 指定额外模型（如LCDSR、GFPGAN等）的路径参数（如GFPGAN_MODELS_PATH）。
**2. Web界面配置****:
- 控制UI界面的行为和外观，如是否启动API，是否显示进度条等。
- 包括认证（gradio-auth, api-auth）、权限管理（允许自定义脚本执行、管理员权限）等高级设置。
- 服务器设置，如监听端口，TLS配置等。
**3. 性能和优化****:
- 针对模型和计算效率优化的各种参数，如水滴注意层（xformers）的使用与否，以及内存和资源使用的调整（如opt-sdp-attention）等。
- 控制GPU和CPU的使用（如--use-cpu），以及计算精度设置（如--precision）。
**4. 特性选项****:
- 自定义UI主题、自动生成时自动在浏览器中打开等便利性功能。
- 兼容性检查和升级选项（例如更新检查、重新安装xformers/torch等）。
- 系统信息的收集和日志级别的设置。
**5. 废弃选项****:
- 提示一些已经过时或不再支持的参数。
**三、结论**
本文档是`stable-diffusion-webui`用户在自定义该程序运行方式和界面行为时的宝贵资源，涵盖了从基础配置到高级设置的各种选项。通过了解和使用这些参数，用户可以精确地控制Stable Diffusion模型的推理过程和Web界面的行为。