stable-diffusion.cpp 新增通义图像模型 day-0 支持

纯 C/C++ 实现的 Diffusion 模型（SD、Flux、Wan 等）推理框架，基于 ggml，工作原理与 llama.cpp 一致。

超轻量级，无外部依赖。

支持的模型

图像模型

SD1.x、SD2.x、SD-Turbo、SDXL、SDXL-Turbo、部分 SD1.x 和 SDXL 蒸馏模型、SD3/SD3.5、FLUX.1-dev/FLUX.1-schnell、FLUX.2-dev/FLUX.2-klein、Lens、Chroma、Chroma1-Radiance、Qwen Image、Qwen Image 2.1、PiD、LongCat Image、Z-Image、MiniT2I、SenseNova U1.5、Ovis-Image、Anima、ERNIE-Image、Boogu Image、Krea2、Mage-Flow、SeFi-Image、HiDream-O1-Image、Ideogram4、LLaDA-Image

图像编辑模型

FLUX.1-Kontext-dev、Qwen Image Edit 系列、LongCat Image Edit、Boogu Image Edit、Mage-Flow-Edit、LLaDA-Image Edit

视频模型

Wan2.1/Wan2.2、MiniMax-H3、LTX-2.3/LTX-2.5、HunyuanVideo 1.5、LingBot-Video

功能特性

• PhotoMaker 支持
• IP-Adapter 支持（SD 1.5 和 SDXL，含 Plus 版本）
• Control Net 支持（SD 1.5）
• ADetailer 支持
• LoRA 支持，与 stable-diffusion-webui 兼容
• 潜在一致性模型支持（LCM/LCM-LoRA）
• TAESD 加速潜在解码，更快、更省内存
• ESRGAN 图片放大

支持的推理后端

• CPU（x86 架构支持 AVX、AVX2 和 AVX512）
• CUDA
• Vulkan
• Metal
• OpenCL
• SYCL

支持的权重格式

• Pytorch checkpoint（.ckpt、.pth 或 .pt）
• Safetensors（.safetensors）
• GGUF（.gguf）

Convert 模式支持将模型权重转换为 .gguf 或 .safetensors 格式。

支持的平台

• Linux
• Mac OS
• Windows
• Android（通过 Termux、Local Diffusion）

其他特性

• Flash Attention 优化内存占用
• stable-diffusion-webui 风格的 tokenizer（非全部功能，目前仅支持 token weighting）
• VAE tiling 处理以降低内存占用

采样方法

Euler A、Euler Heun、DPM2、DPM++ 2M、DPM++ 2M v2、DPM++ 2S a、ER-SDE、LCM

跨平台可复现性

• --rng cuda：默认选项，与 stable-diffusion-webui 的 GPU RNG 一致
• --rng cpu：与 comfyui 的 RNG 一致

生成的 PNG 图片会内嵌 webui 兼容的生成参数文本字符串。

快速上手

获取 sd 可执行文件

从 releases 页面下载预编译二进制文件，或按照构建指南从源码编译。

下载模型权重

下载权重文件（.ckpt、.safetensors 或 .gguf）。以 Stable Diffusion v1.5 为例：

curl -L -O https://huggingface.co/stable-diffusion-v1-5/stable-diffusion-v1-5/resolve/main/v1-5-pruned-emaonly.safetensors

一行命令生成图片

./bin/sd-cli -m ../models/v1-5-pruned-emaonly.safetensors -p "a lovely cat"

详细命令行参数请查阅 cli 文档。

如需提升性能或降低 VRAM/RAM 占用，请参考性能指南。后端运行时及参数放置方式请查阅后端选择指南。

进阶功能

量化与 GGUF

INT8 convrot safetensors

推理加速缓存

社区绑定

以下项目封装了 stable-diffusion.cpp，便于在其他语言/框架中使用：

• Golang（non-cgo）：seasonjs/stable-diffusion
• Golang（cgo）：Binozo/GoStableDiffusion
• Golang（non-cgo）：l8bloom/gosd
• C#：DarthAffe/StableDiffusion.NET
• Python：william-murray1204/stable-diffusion-cpp-python
• Rust：newfla/diffusion-rs
• Flutter/Dart：rmatif/Local-Diffusion

以下项目以 stable-diffusion.cpp 作为后端提供图像生成能力：

Stable Diffusion CLI-GUI

感谢所有为 stable-diffusion.cpp 做出贡献的朋友！