stable-diffusion.cpp 新增通义图像模型 day-0 支持
纯 C/C++ 实现扩散模型推理,新增通义图像模型 Qwen-Image-2.1 的首发支持,支持 SD/Flux/Wan 等多种模型。
完整中文译文
纯 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 做出贡献的朋友!