目录
[一、sd-cli.exe 全部可选参数](#一、sd-cli.exe 全部可选参数)
[1.1 运行与输出控制（CLI 专有）](#1.1 运行与输出控制（CLI 专有）)
[1.2 日志](#1.2 日志)
[二、Context Options（模型加载 / 设备）--- sd-cli 与 sd-server 共用](#二、Context Options（模型加载 / 设备）— sd-cli 与 sd-server 共用)
[2.1 模型与组件路径（string）](#2.1 模型与组件路径（string）)
[2.2 设备 / 后端 / 显存（string + int + bool + manual）](#2.2 设备 / 后端 / 显存（string + int + bool + manual）)
[2.3 精度 / 注意力 / 加速开关](#2.3 精度 / 注意力 / 加速开关)
[三、Default Generation Options（生成参数）--- 两者共用](#三、Default Generation Options（生成参数）— 两者共用)
[3.1 提示词与输入图（string）](#3.1 提示词与输入图（string）)
[3.2 尺寸 / 步数 / 其它整数（int）](#3.2 尺寸 / 步数 / 其它整数（int）)
[3.3 引导 / 强度（float）](#3.3 引导 / 强度（float）)
[3.4 布尔开关](#3.4 布尔开关)
[3.5 采样器 / 调度器 / 缓存 / tiling（manual）](#3.5 采样器 / 调度器 / 缓存 / tiling（manual）)
[四、sd-server.exe 全部可选参数](#四、sd-server.exe 全部可选参数)
[4.1 Svr 专有参数](#4.1 Svr 专有参数)
[4.2 启动示例（含常用组合）](#4.2 启动示例（含常用组合）)
[4.3 服务端点（启动后可用）](#4.3 服务端点（启动后可用）)
来源：leejet/stable-diffusion.cpp 上游 master（整理于 2026-09-22），参数取自源码 examples/cli/main.cpp、examples/common/common.cpp、examples/server/runtime.cpp。 项目仍在校速迭代，以你本机 sd-cli.exe -h 为准 。导出到文件：sd-cli.exe -h > cli_help.txt、sd-server.exe -h > srv_help.txt。
两份程序的参数分为三层：
- CLI 专有 / Svr 专有：各自独有
- Context Options（上下文/模型加载）：两者共用，逐个参数在下面第二节
- Default Generation Options（默认生成参数）：两者共用，在第三节
一、sd-cli.exe 全部可选参数
1.1 运行与输出控制（CLI 专有）
| 参数 | 说明 | 示例值 |
|---|---|---|
-o, --output |
结果图输出路径，支持 printf 风格 %d 序号；单文件视频支持 .avi/.webm/.webp |
-o out_%03d.png |
--image |
要检查的图片路径（仅 metadata 模式用） | --image ./output.png |
--metadata-format |
metadata 模式输出格式：text / json（默认 text） |
--metadata-format json |
--preview-path |
预览图输出路径（默认 ./preview.png），支持 %03d 序号 |
--preview-path ./prev.png |
--imat-out |
本次运行计算 imatrix 并保存到该路径 | --imat-out model.imatrix |
--imat-in |
加载 imatrix 文件（用于量化或继续收集），可多次指定 | --imat-in a.imatrix --imat-in b.imatrix |
--preview-interval |
预览间隔：正数 N=每 N 步更新；-N=只在第 N 个逻辑步预览；0=只在首轮最后一步预览（默认 1） | --preview-interval 5 |
--output-begin-idx |
输出图片序列起始序号，须非负（默认有 %d 时 0，否则 1） |
--output-begin-idx 100 |
--compression-quality |
视频与 JPEG/WebP 压缩质量（默认 90） | --compression-quality 95 |
-M, --mode |
运行模式：img_gen / adetailer / vid_gen / convert / upscale / metadata（默认 img_gen） |
-M convert |
--preview |
预览方式：none / proj / tae / vae（默认 none） |
--preview tae |
--canny |
启用 canny 边缘检测预处理 | --canny |
--convert-name |
转换张量名（仅 convert 模式） | --convert-name |
--color |
按日志级别给日志标签上色 | --color |
--taesd-preview-only |
禁止用 taesd 解码最终图（配合 --preview tae） |
--taesd-preview-only |
--preview-noisy |
预览模型的含噪输入而非去噪输出 | --preview-noisy |
--metadata-raw |
输出未解析 metadata 的原始 hex 预览 | --metadata-raw |
--metadata-brief |
文本输出中截断过长的 metadata 值 | --metadata-brief |
--metadata-all |
包含结构/容器条目（IHDR、IDAT、非 metadata 的 JPEG 段） | --metadata-all |
-h, --help |
显示帮助并退出 | -h |
- img_gen：这是图像生成模式，用于基于给定的参数和模型生成静态图像。比如你可以输入一些描述性的文字等信息，让模型根据这些生成对应的图片。
- adetailer：人体/角色细节修复优化模式，主要针对图像中的人物或角色细节进行修复和优化处理，能让人物的五官、服饰细节等更加清晰和精致。
- vid_gen：视频生成模式，像通义万相2.1 - 文生视频 - 1.3B这类模型会用到此模式，它可以根据输入的文本等信息生成动态的视频内容。
- convert：转换模式，可能用于不同格式、不同类型模型之间的转换等相关操作，比如将模型从一种存储格式转换为另一种适合特定场景使用的格式。
- upscale：图像超分辨率提升模式，可以把低分辨率的图像进行放大并提升其分辨率，让图像在放大后依然能保持较好的清晰度和细节，减少模糊和锯齿现象。
- metadata：元数据处理模式，用于处理模型或图像等相关文件的元数据信息，比如查看、修改模型的元数据等操作。
-M metadata用法示例：sd-cli.exe -M metadata --image ./out.png --metadata-format json；-M convert会把默认输出名从output.png改为output.gguf。
1.2 日志
| 参数 | 说明 | 示例值 |
|---|---|---|
--log-level |
最低日志级别：debug / verbose / info / warn / error（默认 info） |
--log-level debug |
-v, --verbose |
等价于 --log-level verbose |
-v |
（重复指定时以最后一个为准。）
二、Context Options（模型加载 / 设备）--- sd-cli 与 sd-server 共用
2.1 模型与组件路径（string）
| 参数 | 说明 | 示例值 |
|---|---|---|
-m, --model |
完整模型路径（单文件模型） | -m models/sd15.safetensors |
--diffusion-model |
独立的 diffusion 模型路径 | --diffusion-model z_image_turbo_bf16.safetensors |
--high-noise-diffusion-model |
独立的 high-noise diffusion 模型 | --high-noise-diffusion-model wan_high.gguf |
--uncond-diffusion-model |
独立的无条件 diffusion 模型（当前用于 Ideogram4 CFG） | --uncond-diffusion-model uncond.gguf |
--clip_l |
clip-l 文本编码器路径 | --clip_l clip_l.safetensors |
--clip_g |
clip-g 文本编码器路径 | --clip_g clip_g.safetensors |
--clip_vision |
clip-vision 编码器路径（IP-Adapter 需要） | --clip_vision clip_vision.safetensors |
--t5xxl |
t5xxl 文本编码器路径 | --t5xxl t5xxl-q4_k.gguf |
--llm |
LLM 文本编码器路径（如 qwen-image 用 qwenvl2.5、flux2 用 mistral-small3.2） | --llm qwen_3_4b.safetensors |
--llm_vision |
LLM 的 ViT 路径 | --llm_vision vit.safetensors |
--tokenizer |
tokenizer.json 路径，或 main=FILE,clip-l=FILE,clip-g=FILE；PiD / Lens 必需 |
--tokenizer tokenizer.json |
--qwen2vl |
--llm 的别名（已弃用） |
--qwen2vl model.safetensors |
--qwen2vl_vision |
--llm_vision 的别名（已弃用） |
--qwen2vl_vision vit.safetensors |
--embeddings-connectors |
LTXAV embeddings connectors 路径 | --embeddings-connectors conn.safetensors |
--vae |
独立 VAE 模型路径 | --vae ae.safetensors |
--vae-format |
VAE latent 格式覆盖：auto/flux/sd3/flux2/wan（默认 auto） |
--vae-format flux |
--audio-vae |
独立 LTX 音频 VAE | --audio-vae audio_vae.safetensors |
--audio-encoder |
wav2vec2 音频编码器（Wan2.2 S2V） | --audio-encoder wav2vec2.gguf |
--taesd |
taesd 路径（Tiny AutoEncoder 快速解码，质量较低） | --taesd taesd.safetensors |
--tae |
--taesd 的别名 |
--tae taesd.safetensors |
--control-net |
ControlNet 模型路径 | --control-net control_canny.safetensors |
--ip-adapter |
IP-Adapter 模型路径（需 --clip_vision） |
--ip-adapter ip-adapter.safetensors |
--motion-module |
AnimateDiff motion module（SD1.5，配合 --video-frames > 1） |
--motion-module mm_sd15.ckpt |
--embd-dir |
embeddings 目录 | --embd-dir ./embeddings |
--lora-model-dir |
LoRA 模型目录（默认 .） |
--lora-model-dir ./loras |
--hires-upscalers-dir |
Highres-fix 放大模型目录 | --hires-upscalers-dir ./upscalers |
--photo-maker |
PhotoMaker 模型路径 | --photo-maker photomaker.gguf |
--pulid-weights |
PuLID Flux 权重路径 | --pulid-weights pulid.safetensors |
--upscale-model |
ESRGAN 放大模型路径（upscale 模式必需） | --upscale-model 4x-UltraSharp.gguf |
--tensor-type-rules |
按张量名指定权重类型，逗号分隔 | --tensor-type-rules "^vae\.=f16,model\.=q8_0" |
--model-args |
额外模型参数，key=value 列表（chroma_use_dit_mask、chroma_use_t5_mask、chroma_t5_mask_pad、qwen_image_zero_cond_t） | --model-args qwen_image_zero_cond_t=1 |
2.2 设备 / 后端 / 显存（string + int + bool + manual）
| 参数 | 说明 | 示例值 |
|---|---|---|
--backend |
运行时后端分配，逗号分隔 | --backend clip=cpu,vae=cuda0,diffusion=vulkan0 |
--params-backend |
参数存放后端：disk / cpu / 按模块 |
--params-backend diffusion=disk,clip=cpu |
--split-mode |
多设备权重切分：layer（整块 transformer 分设备，默认）或 row（matmul 行切分，仅 CUDA）；支持按模块 |
--split-mode diffusion=row,te=layer |
--rpc-servers |
RPC 卸载服务器列表 host:port，逗号分隔 |
--rpc-servers 127.0.0.1:50052 |
--max-vram |
每设备显存预算（GiB），可单值或按设备；0=用实时空闲显存，负值=预留 | --max-vram cuda0=6,vulkan0=4 |
--auto-fit |
on/off（默认 on）：自动按可用内存把权重放到 计算GPU→RAM→另一GPU→磁盘 |
--auto-fit on |
-t, --threads |
计算线程数（默认 -1）；≤0 时取 CPU 物理核心数 | -t 8 |
--offload-to-cpu |
权重放内存省显存，需要时再载入显存 | --offload-to-cpu |
--mmap |
是否内存映射模型 | --mmap |
--disable-prefetch |
关闭异步下一段权重预取（默认 false） | --disable-prefetch |
--disable-segmented-compute |
强制单块图执行（即使需要自动图切分） | --disable-segmented-compute |
--eager-load |
模型加载时即把所有参数载入 params 后端，而非首次使用时惰性加载 | --eager-load |
--list-devices |
列出可用 ggml 后端设备（name<TAB>description）后退出 |
--list-devices |
--control-net-cpu |
⚠️已弃用，改用 --backend controlnet=cpu |
--control-net-cpu |
--clip-on-cpu |
⚠️已弃用，改用 --backend te=cpu |
--clip-on-cpu |
--vae-on-cpu |
⚠️已弃用，改用 --backend vae=cpu |
--vae-on-cpu |
2.3 精度 / 注意力 / 加速开关
| 参数 | 说明 | 示例值 |
|---|---|---|
--type |
权重类型：f32,f16,bf16,q4_0,q4_1,q5_0,q5_1,q8_0,q2_K,q3_K,q4_K,q5_K,q6_K,q8_K,iq*,mxfp4,nvfp4,f8_e4m3,...；默认=权重文件类型 |
--type q8_0 |
--fa |
全局启用 flash attention | --fa |
--diffusion-fa |
仅 diffusion 模型启用 flash attention | --diffusion-fa |
--sage-attn |
diffusion 模型用 CUDA SageAttention（回退 flash/默认） | --sage-attn |
--diffusion-conv-direct |
diffusion 模型用 ggml_conv2d_direct |
--diffusion-conv-direct |
--vae-conv-direct |
VAE 用直接 2D/3D 卷积 | --vae-conv-direct |
--force-sdxl-vae-conv-scale |
强制对 SDXL VAE 使用 conv scale | --force-sdxl-vae-conv-scale |
--linear-scale |
线性输入缩放覆盖（float，默认 0=模型默认，1=不缩放） | --linear-scale 1 |
--attn-scale |
FA 的 K/V scale 覆盖（float，默认 0=模型默认）；需 --fa/--diffusion-fa |
--attn-scale 1 |
--rng |
随机数后端：std_default / cuda（对齐 sd-webui GPU RNG）/ cpu（对齐 comfyui RNG），默认 cuda |
--rng cpu |
--sampler-rng |
采样器 RNG：std_default / cuda / cpu；不设则用 --rng |
--sampler-rng cpu |
--prediction |
预测类型覆盖：eps / v / edm_v / sd3_flow / flux_flow / sefi_flow / minit2i_flow / sensenova_u1_flow |
--prediction v |
--lora-apply-mode |
LoRA 应用方式：auto / immediately / at_runtime（默认 auto） |
--lora-apply-mode at_runtime |
三、Default Generation Options（生成参数）--- 两者共用
3.1 提示词与输入图（string）
| 参数 | 说明 | 示例值 |
|---|---|---|
-p, --prompt |
正向提示词 | -p "a lovely cat" |
-n, --negative-prompt |
负向提示词（默认 ""） | -n "blurry, lowres" |
--prompt-file |
从文件读取正向提示词 | --prompt-file prompt.txt |
--negative-prompt-file |
从文件读取负向提示词 | --negative-prompt-file neg.txt |
-i, --init-img |
初始图路径（img2img） | -i init.png |
--end-img |
结束图路径（flf2v 需要） | --end-img end.png |
--mask |
遮罩图路径（inpaint） | --mask mask.png |
--control-image |
ControlNet 控制图 | --control-image pose.png |
--control-video |
控制视频帧目录（帧按文件名字典序，如 00.png,01.png...） | --control-video ./frames |
--ip-adapter-image |
IP-Adapter 参考图 | --ip-adapter-image ref.png |
-r, --ref-image |
参考图（Flux Kontext / MiniMax-H3 Ref2VA），可多次 | -r a.png -r b.png |
--ref-video |
MiniMax-H3 Ref2VA 参考视频帧目录（24fps），可多次 | --ref-video ./vidframes |
--ref-video-audio |
与 --ref-video 按序号配对的 WAV，可多次 |
--ref-video-audio a.wav |
--ref-audio |
独立 WAV 参考（MiniMax-H3 Ref2VA），可多次 | --ref-audio voice.wav |
--audio |
驱动音频轨（Wan2.2 S2V，仅一次） | --audio speech.wav |
--ref-image-args |
参考图处理方式 key=value（空=按模型权重自动探测） | --ref-image-args mode=edit |
--pm-id-images-dir |
PhotoMaker 输入 ID 图目录 | --pm-id-images-dir ./ids |
--pm-id-embed-path |
PhotoMaker v2 ID embed 路径 | --pm-id-embed-path id.bin |
--pulid-id-embedding |
PuLID ID embedding 路径 | --pulid-id-embedding id.npy |
--ad-model |
ADetailer 的 YOLOv8 检测模型（转换后） | --ad-model face_yolov8n.gguf |
--ad-prompt |
ADetailer 提示词；空则继承主提示词，支持 [PROMPT]/[SEP]/[SKIP] |
--ad-prompt "[PROMPT], detailed face" |
--ad-negative-prompt |
ADetailer 负向提示词；空则继承主负向词 | --ad-negative-prompt "blurry" |
--extra-ad-args |
ADetailer 额外参数 key=value（input_size、confidence、nms、denoising_strength、steps、cfg_scale、sort_by 等） | --extra-ad-args confidence=0.3,steps=20 |
--extra-sample-args |
采样器/调度器/引导额外参数 key=value（CFG guidance_schedule；APG apg_eta 等；SLG slg_uncond；lcm noise_clip_std 等；flux base_shift/max_shift；beta alpha/beta；logit_normal mu/std 等） | --extra-sample-args base_shift=0.5,max_shift=1.15 |
--extra-tiling-args |
VAE tiling 额外参数（视频 VAE 支持 temporal_tile_frames/temporal_tile_size/temporal_tile_overlap） | --extra-tiling-args temporal_tile_frames=8 |
3.2 尺寸 / 步数 / 其它整数（int）
| 参数 | 说明 | 示例值 |
|---|---|---|
-W, --width |
图像宽度（像素，默认 512） | -W 1024 |
-H, --height |
图像高度（像素，默认 512） | -H 1024 |
--steps |
采样步数（默认 20） | --steps 28 |
--high-noise-steps |
(high noise) 采样步数（默认 -1=自动） | --high-noise-steps 15 |
--clip-skip |
忽略 CLIP 最后几层；1=不忽略，2=忽略一层（默认 -1，SD1.x→1、SD2.x→2） | --clip-skip 2 |
-b, --batch-count |
批次数量 | -b 4 |
--qwen-image-layers |
Qwen Image Layered 层数，latent/输出数=层数+1（默认 3） | --qwen-image-layers 3 |
--video-frames |
视频帧数（默认 1） | --video-frames 25 |
--fps |
帧率（默认 24） | --fps 16 |
--timestep-shift |
NitroFusion 模型时间步偏移（默认 0；NitroSD-Realism≈250，NitroSD-Vibrant≈500） | --timestep-shift 250 |
--upscale-repeats |
ESRGAN 放大重复次数（默认 1） | --upscale-repeats 2 |
--upscale-tile-size |
ESRGAN 放大分块大小（默认 128） | --upscale-tile-size 256 |
--hires-width |
Highres-fix 目标宽，0=用 --hires-scale（默认 0） |
--hires-width 2048 |
--hires-height |
Highres-fix 目标高，0=用 --hires-scale（默认 0） |
--hires-height 2048 |
--hires-steps |
Highres-fix 二阶段步数，0=复用 --steps（默认 0） |
--hires-steps 15 |
--hires-upscale-tile-size |
Highres-fix 放大器分块（保留给模型型放大器，默认 128） | --hires-upscale-tile-size 256 |
3.3 引导 / 强度（float）
| 参数 | 说明 | 示例值 |
|---|---|---|
--cfg-scale |
无条件引导强度（默认 7.0） | --cfg-scale 5.0 |
--img-cfg-scale |
inpaint/图像编辑模型的图像引导（默认同 --cfg-scale） |
--img-cfg-scale 1.5 |
--guidance |
有 guidance 输入端模型的蒸馏引导（默认 3.5） | --guidance 3.5 |
--slg-scale |
SLG 跳过层引导强度（仅 DiT；默认 0=禁用；sd3.5 medium 用 2.5 不错） | --slg-scale 2.5 |
--skip-layer-start |
SLG 启用点（默认 0.01） | --skip-layer-start 0.01 |
--skip-layer-end |
SLG 关闭点（默认 0.2） | --skip-layer-end 0.2 |
--eta |
噪声乘子（默认 ddim_trailing/tcd/res_multistep/res_2s 为 0；euler_a/er_sde/dpm++2s_a/dpm++2m_sde 为 1） | --eta 1.0 |
--flow-shift |
Flow 模型（SD3.x/WAN）shift 值（默认 auto） | --flow-shift 3.0 |
--high-noise-cfg-scale |
(high noise) 无条件引导（默认 7.0） | --high-noise-cfg-scale 5.0 |
--high-noise-img-cfg-scale |
(high noise) 图像引导 | --high-noise-img-cfg-scale 1.5 |
--high-noise-guidance |
(high noise) 蒸馏引导（默认 3.5） | --high-noise-guidance 3.5 |
--high-noise-slg-scale |
(high noise) SLG 强度（默认 0） | --high-noise-slg-scale 2.5 |
--high-noise-skip-layer-start |
(high noise) SLG 启用点（默认 0.01） | --high-noise-skip-layer-start 0.01 |
--high-noise-skip-layer-end |
(high noise) SLG 关闭点（默认 0.2） | --high-noise-skip-layer-end 0.2 |
--high-noise-eta |
(high noise) 噪声乘子 | --high-noise-eta 1.0 |
--strength |
img2img 加噪/去噪强度（默认 0.75） | --strength 0.6 |
--control-strength |
ControlNet 强度（默认 0.9；1.0=完全破坏初始图信息） | --control-strength 1.0 |
--ip-adapter-strength |
IP-Adapter 强度（默认 1.0） | --ip-adapter-strength 0.8 |
--pm-style-strength |
PhotoMaker 风格强度（默认 20） | --pm-style-strength 20 |
--pulid-id-weight |
PuLID 身份注入强度 | --pulid-id-weight 1.0 |
--moe-boundary |
Wan2.2 MoE 时间步边界（默认 0.875，仅当 --high-noise-steps -1 生效） |
--moe-boundary 0.875 |
--vace-strength |
Wan VACE 强度 | --vace-strength 1.0 |
--vae-tile-overlap |
VAE tiling 重叠比例（默认 0.5） | --vae-tile-overlap 0.5 |
--hires-scale |
Highres-fix 缩放倍数（未设目标尺寸时用，默认 2.0） | --hires-scale 1.5 |
--hires-denoising-strength |
Highres-fix 二阶段去噪强度（默认 0.7） | --hires-denoising-strength 0.6 |
3.4 布尔开关
| 参数 | 说明 | 示例值 |
|---|---|---|
--vae-tiling |
VAE 分块处理以降显存 | --vae-tiling |
--temporal-tiling |
支持视频 VAE 解码的时间分块 | --temporal-tiling |
--hires |
启用 Highres-fix | --hires |
--circular |
双轴循环填充（可平铺输出） | --circular |
--circularx |
仅 X 轴（宽）循环填充 | --circularx |
--circulary |
仅 Y 轴（高）循环填充 | --circulary |
--increase-ref-index |
按列出顺序自动递增参考图索引（从 1 开始） | --increase-ref-index |
--disable-auto-resize-ref-image |
关闭参考图自动缩放 | --disable-auto-resize-ref-image |
--disable-image-metadata |
不在图片里写入生成 metadata | --disable-image-metadata |
3.5 采样器 / 调度器 / 缓存 / tiling（manual）
| 参数 | 说明 | 示例值 |
|---|---|---|
-s, --seed |
随机种子（默认 42，<0 为随机） | -s 12345 |
--sampling-method |
采样方法，取值：euler euler_a heun dpm2 dpm++2s_a dpm++2m dpm++2mv2 ipndm ipndm_v lcm ddim_trailing tcd res_multistep res_2s er_sde euler_cfg_pp euler_a_cfg_pp euler_ge dpm++2m_sde dpm++2m_sde_bt lms；默认 Flux/SD3/Wan 用 euler，其余 euler_a |
--sampling-method dpm++2m |
--high-noise-sampling-method |
(high noise) 采样方法，取值同上 | --high-noise-sampling-method euler |
--scheduler |
调度器，取值：discrete karras exponential ays gits sgm_uniform simple smoothstep kl_optimal lcm bong_tangent ltx2 logit_normal flux2 flux beta llada_image（别名 normal=discrete，默认按模型） |
--scheduler karras |
--sigmas |
自定义 sigma，逗号分隔 | --sigmas "14.61,7.8,3.5,0.0" |
--hires-sigmas |
Highres-fix 二阶段自定义 sigma | --hires-sigmas "0.85,0.725,0.42,0.0" |
--skip-layers |
SLG 跳过的层（默认 [7,8,9]） |
--skip-layers [7,8,9] |
--high-noise-skip-layers |
(high noise) SLG 跳过层（默认 [7,8,9]） |
--high-noise-skip-layers [7,8,9] |
--vae-tile-size |
VAE tiling 块大小（latent 单位 ，非像素），格式 [X]x[Y]（默认 32x32） |
--vae-tile-size 64x64 |
--vae-relative-tile-size |
相对块大小 [X]x[Y]（<1 为占比，≥1 为分块数；覆盖 --vae-tile-size） |
--vae-relative-tile-size 0.5x0.5 |
--hires-upscaler |
Highres-fix 放大器：Lanczos Nearest Latent Latent (nearest) Latent (nearest-exact) Latent (antialiased) Latent (bicubic) Latent (bicubic antialiased)，或 --hires-upscalers-dir 下的模型名（默认 Latent） |
--hires-upscaler Lanczos |
--cache-mode |
缓存加速方式：easycache（DiT）、ucache（UNET）、dbcache/taylorseer/cache-dit（DiT 块级）、spectrum（UNET/DiT Chebyshev+Taylor 预测） |
--cache-mode easycache |
--cache-option |
缓存参数 key=value（easycache/ucache: threshold,start,end,decay,relative,reset；dbcache/taylorseer/cache-dit: Fn,Bn,threshold,warmup；spectrum: w,m,lam,window,flex,warmup,stop） | --cache-option threshold=0.25 |
--scm-mask |
cache-dit 的 SCM 步掩码，逗号分隔 0/1（1=计算，0=可缓存） | --scm-mask "1,1,1,0,0,1,0,0,1,0" |
--scm-policy |
SCM 策略：dynamic（默认）/ static |
--scm-policy static |
四、sd-server.exe 全部可选参数
sd-server = Svr 专有参数 + Context Options（即本文第二节，全部） + Default Generation Options（即本文第三节，全部）。 后两组在启动时作为"默认加载/默认生成"参数，含义与 sd-cli 完全一致，此处不重复展开。
4.1 Svr 专有参数
| 参数 | 说明 | 示例值 |
|---|---|---|
-l, --listen-ip |
监听地址（默认 127.0.0.1） |
-l 0.0.0.0 |
--listen-port |
监听端口（默认 1234，范围 0--65535） |
--listen-port 8080 |
--serve-html-path |
在根路径 / 提供的自定义 HTML 文件（覆盖内嵌前端） |
--serve-html-path ./index.html |
--color |
按级别给日志标签上色 | --color |
-h, --help |
显示帮助并退出 | -h |
--log-level |
最低日志级别：debug/verbose/info/warn/error（默认 info） |
--log-level debug |
-v, --verbose |
等价于 --log-level verbose |
-v |
--version |
打印版本号并退出（仅当作为第一个参数） | sd-server.exe --version |
注意：
sd-server没有-o/--output、--image、-M/--mode、--preview*、--imat-*、--canny、metadata 系列等 CLI 专有参数（那些属于 sd-cli）。
4.2 启动示例（含常用组合）
powershell
# 最简：单文件模型
sd-server.exe -m models\sd15.safetensors -l 127.0.0.1 --listen-port 1234
# 独立 diffusion + VAE + LLM 文本编码器（Z-Image 风格）
sd-server.exe --diffusion-model z_image_turbo_bf16.safetensors `
--vae ae.sft --llm qwen_3_4b.safetensors `
--diffusion-fa --offload-to-cpu -v --cfg-scale 1.0
# 开放到局域网 + 固定默认参数
sd-server.exe -m models\sdxl.gguf --vae sdxl-vae.safetensors `
-l 0.0.0.0 --listen-port 8080 `
--cfg-scale 6 --sampling-method dpm++2m --scheduler karras `
--steps 28 --vae-tiling --fa4.3 服务端点（启动后可用）
- 内嵌 Web UI ：
http://127.0.0.1:1234/ - OpenAI 兼容 API （
/v1/...）：POST /v1/images/generations、POST /v1/images/edits、GET /v1/models - WebUI(A1111) 兼容 API （
/sdapi/v1/...）：POST txt2img、POST img2img、GET loras、upscalers、latent-upscale-modes、samplers、schedulers、sd-models、options - 原生异步 API （
/sdcpp/v1/...）：GET capabilities、POST img_gen、POST vid_gen、GET jobs/{id}、POST jobs/{id}/cancel
附：常用取值速查
- 模式
-M：img_genadetailervid_genconvertupscalemetadata - 预览
--preview：noneprojtaevae - RNG
--rng/--sampler-rng：std_defaultcudacpu - 预测
--prediction：epsvedm_vsd3_flowflux_flowsefi_flowminit2i_flowsensenova_u1_flow - LoRA 应用
--lora-apply-mode：autoimmediatelyat_runtime - VAE 格式
--vae-format：autofluxsd3flux2wan - 缓存
--cache-mode：easycacheucachedbcachetaylorseercache-ditspectrum - 采样方法
--sampling-method：21 种（见 3.5） - 调度器
--scheduler：17 种 + 别名normal（见 3.5）