全部参数

常用配置

参数命令	值类型	默认	描述
配置
-h, --help	None	False	显示此帮助消息并退出。
	None		安装后终止
--no-download-sd-model	None	False	即使找不到模型，也不要下载SD1.5模型。
--do-not-download-clip	None	False	不下载CLIP模型，即使它不包括在检查点
--max-batch-count	MAX_BATCH_COUNT	16	UI 的最大批处理计数值。
--allow-code	None	False	允许从 Web UI 执行自定义脚本。
--freeze-settings	None	False	禁用编辑设置。
--enable-insecure-extension-access	None	False	启用扩展选项卡，而不考虑其他选项。
--ui-debug-mode	None	False	不加载模型以快速启动 UI。
--device-id	DEVICE_ID	None	选择要使用的默认 CUDA 设备（可能需要在之前导出 CUDA_VISIBLE_DEVICES=0,1 等）。
--administrator	None	False	管理员权限。
--no-hashing	False	None	禁用对检查点进行 SHA-256 散列以提高加载性能。
--timeout-keep-alive	int	30	为 uvicorn 设置 timeout_keep_alive。

Web UI 配置和服务器设置

参数命令	值类型	默认	描述
Web UI 配置和服务器设置
--listen	None	False	以 0.0.0.0 作为服务器名称启动 Gradio，允许响应网络请求。
--port	PORT	7860	以指定的服务器端口启动 Gradio，对于端口 < 1024，需要 root/admin 权限；如果可用，默认为 7860。
--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	False	None	当传递时，启用使用自签名证书。
--server-name	SERVER_NAME	None	设置服务器的主机名。

跳过检查

参数命令	值类型	默认	描述
跳过检查
--skip-version-check	False	None	不检查 torch 和 xformers 的版本。
--skip-python-version-check	False	None	不检查 Python 的版本。
--skip-torch-cuda-test	False	None	不检查 CUDA 是否能够正常工作。
--skip-install	False	None	跳过包的安装。

日志

参数命令	值类型	默认	描述
日志
--loglevel	None	None	日志级别；其中之一：CRITICAL，ERROR，WARNING，INFO，DEBUG。
--log-startup	False	None	launch.py 参数：打印启动时正在发生的详细日志。
--disable-console-progressbars	None	False	不将进度条输出到控制台。
--enable-console-prompts	None	False	生成 txt2img 和 img2img 时在控制台上打印提示。

Gradio设置

参数命令	值类型	默认	描述
--share	None	False	使用 share=True 为 gradio，并通过其站点访问 UI。
Gradio设置
--no-gradio-queue	False	None	禁用 Gradio 队列；使网页使用 HTTP 请求而不是 Websockets；在早期版本中是默认的。
--gradio-allowed-path	None	None	添加到 Gradio's allowed_paths 的路径；使其可以从中提供文件。
--gradio-debug	None	False	使用 --debug 选项启动 Gradio。
--gradio-auth	GRADIO_AUTH	None	设置 Gradio 身份验证，如用户名:密码；或逗号分隔多个，如 u1:p1,u2:p2,u3:p3。
--gradio-auth-path	GRADIO_AUTH_PATH	None	设置 Gradio 身份验证文件路径，例如 /path/to/auth/file，与 --gradio-auth 使用相同的身份验证格式。
--no-progressbar-hiding	None	False	在 Gradio UI 中不隐藏进度条（我们隐藏它是因为如果浏览器有硬件加速，它会减慢 ML）。

API设置

参数命令	值类型	默认	描述
特性
--api	None	False	使用 API 启动 Web UI。
--api-auth	API_AUTH	None	为 API 设置身份验证，格式为用户名:密码；或逗号分隔多个，如 u1:p1,u2:p2,u3:p3。
--api-log	None	False	启用记录所有 API 请求的日志。
--nowebui	None	False	仅启动 API，不启动 UI。
--api-server-stop	False	None	启用通过 API 停止/重新启动/终止服务器。

性能

参数命令	值类型	默认	描述
性能
--xformers	False	None	启用 xformers 用于跨注意力层。
--force-enable-xformers	False	None	强制启用 xformers 用于跨注意力层，不管检查代码是否认为可以运行；如果此操作无法正常工作，请不要提交错误报告。
--xformers-flash-attention	False	None	启用 xformers 与 Flash Attention 以提高可重复性（仅支持 SD2.x 或变体）。
--opt-sdp-attention	False	None	启用缩放点积跨注意力层优化；需要 PyTorch 2.*。
--opt-sdp-no-mem-attention	False	None	启用缩放点积跨注意力层优化，不使用内存有效的注意力，使图像生成具有确定性；需要 PyTorch 2.*。
--opt-split-attention	False	None	强制启用 Doggettx 的跨注意力层优化。默认情况下，对于启用 CUDA 的系统，它是开启的。
--opt-split-attention-invokeai	False	None	强制启用 InvokeAI 的跨注意力层优化。默认情况下，如果 CUDA 不可用，它会开启。
--opt-split-attention-v1	False	None	启用旧版的分割注意力优化，不会消耗所有可用的VRAM。
--opt-sub-quad-attention	False	None	启用内存高效的次二次交叉注意力层优化。
--sub-quad-q-chunk-size	SUB_QUAD_Q_CHUNK_SIZE	1024	子二次交叉注意力层优化使用的查询块大小。
--sub-quad-kv-chunk-size	SUB_QUAD_KV_CHUNK_SIZE	None	子二次交叉注意力层优化使用的键值块大小。
--sub-quad-chunk-threshold	SUB_QUAD_CHUNK_THRESHOLD	None	子二次交叉注意力层优化使用分块的VRAM阈值的百分比。
--opt-channelslast	False	None	启用4D张量的替代布局，可能在仅支持Nvidia Tensor Cores（16xx及更高版本）的卡上实现更快的推断。
--disable-opt-split-attention	False	None	强制禁用交叉注意力层优化。
--disable-nan-check	False	None	不检查生成的图像/潜在空间是否包含NaN；在CI中运行时很有用，无需检查点。
--use-cpu	[all, sd, interrogate, gfpgan, bsrgan, esrgan, scunet, codeformer]	None	使用 CPU 作为 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 使用。
--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 authtoken，用于 gradio --share 的替代方案。
--ngrok-region	NGROK_REGION	us	ngrok 启动时应该在其中启动的区域。
--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 参数：将有限的 sysinfo 文件（不包含有关扩展、选项信息的信息）写入磁盘并退出。
--disable-all-extensions	None	False	禁用所有非内置扩展的运行。
--disable-extra-extensions	None	False	禁用所有扩展的运行。

路径配置

参数命令	值类型	默认	描述
路径
--hide-ui-dir-config	None	False	隐藏 Web UI 中的目录配置。
--ui-settings-file	UI_SETTINGS_FILE	config.json	用于 UI 设置的文件名。
--data-dir	DATA_DIR	./	存储所有用户数据的基本路径。
--config	CONFIG	configs/stable-diffusion/v1-inference.yaml	构造模型的配置路径。
--ckpt	CKPT	model.ckpt	稳定扩散模型的检查点路径如果指定了该检查点，则该检查点将被添加到检查点列表中并加载。
--ckpt-dir	CKPT_DIR	None	具有稳定扩散检查点的目录的路径。
--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.	GFPGAN目录.
--codeformer-models-path	CODEFORMER_MODELS_PATH	models/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 模型文件的目录路径。
--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 配置的文件名。

已废弃选项

参数命令	值类型	默认	描述
默认选项
--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 的设置 > 优化 中。