本页由英文机器翻译而成。阅读英文原文。

本地图像和视频生成

官方运行时GPUv1.3.1aigd.sdcpp
安装 还没安装应用?免费下载
或从终端安装
gamedev pkg add aigd.sdcpp
在你的电脑上运行。 只需下载一次模型,之后即可在这台电脑的 GPU 上生成。

概览

在本机使用 stable-diffusion.cpp 生成图像、纹理和短视频片段:NVIDIA(CUDA)、AMD 和 Intel(Vulkan)、Apple 芯片(Metal)或处理器。添加 Image Gen 和 Video 工具。模型是独立的包(Z-Image Turbo、FLUX、SDXL、Qwen-Image、LTX-2.5、Wan 2.2 等)。

Apple 芯片

这个运行时让 AI Game Dev 在本机、在你自己的 GPU 上(或者对于在该硬件上测量过的模型,用它的处理器),借助 stable-diffusion.cpp 生成图像、纹理和短视频片段。所有内容都在你的电脑上生成,而且生成不产生任何费用。它是下面每一个本地图像和视频模型包背后的引擎:安装一次,然后添加适合你的电脑和游戏的模型。

这个包只包含数据(aigd-package.json,不含代码)。它会告诉 AI Game Dev 该为你的电脑下载哪个 stable-diffusion.cpp 版本,并在会话的 Tools 栏中添加两个开关:Image Gen 和 Video。在你于会话中开启它们之前,两者都是关闭的。程序由应用自行下载、校验并运行。

功能

  • 为你的电脑下载合适的 stable-diffusion.cpp 构建(NVIDIA CUDA,AMD / Intel / 其他 GPU 用 Vulkan,Apple 芯片 Mac 用 Metal,或使用处理器),并通过 sha256 校验。
  • 让智能体用你安装的模型包生成图像(文生图、图生图、编辑)和片段(文生视频、图生视频)。
  • 当你没有指定模型时,自动挑选已下载且适合你电脑的最佳模型(default model 和 default video model 设置会覆盖这一选择)。
  • 为图像和片段运行同一个共享队列(见下文),并可选设置生成时间上限和 GPU 显存预算。

模型是独立的包

这个包不包含任何模型。请在 Packages 浏览器中安装模型包(例如 aigd.image-z-image-turbo,片段则用 aigd.video-ltx25 / aigd.video-wan22-ti2v-5b),然后在 Models 面板中下载其文件。没有你的确认就不会下载任何内容,而且你会先看到大小——智能体请求模型时也一样。

图像模型

包最适合电脑
Z-Image Turbo快速生成写实和插画风格图像、短文本NVIDIA 4 GB+,其他 GPU 8 GB+,集成 GPU(较慢)
FLUX.1 schnell4 步生成插画、照片、图标、精灵图NVIDIA 8 GB+
FLUX.2 klein 4B插画、图标、精灵图Apple 芯片 Mac
SDXL 1.0通用插画、概念设计图、照片NVIDIA 8 GB+
Animagine XL 4.0动漫角色和插画NVIDIA 8 GB+
Juggernaut XL v9电影感写实图像NVIDIA 8 GB+
RealVisXL V5.0写实人物、场景、产品NVIDIA 8 GB+
Qwen-Image文字渲染、UI 界面稿、海报NVIDIA 16 GB+, 32 GB RAM
Qwen-Image-2512文字渲染与提示词遵循,20 步NVIDIA 16 GB+, 32 GB RAM
Qwen-Image-2512 Lightning4 步实现同样效果NVIDIA 16 GB+, 32 GB RAM
Qwen-Image-Edit-2511按指令编辑图像,20 步NVIDIA 16 GB+, 32 GB RAM
Qwen-Image-Edit-2511 Lightning4 步实现同样效果NVIDIA 16 GB+, 32 GB RAM
Qwen-Image-2.1 Turbo Q3透明背景(非商业用途)NVIDIA 6–8 GB, 16 GB RAM
Qwen-Image-2.1 Turbo透明背景(非商业用途)NVIDIA 8 GB+、16 GB 内存;或 Windows 电脑的处理器
Qwen-Image-2.1 Turbo Q8透明背景(非商业用途)NVIDIA 12 GB+, 24 GB RAM

视频模型

包最适合电脑
LTX-2.5带同步声音、文本或起始图像的片段NVIDIA 16 GB+, 48 GB RAM
Wan 2.2 TI2V 5B无声音的片段,开放许可证NVIDIA 12 GB+, 16 GB RAM

每个模型包都会说明自己的许可证以及测量时所用的电脑。

示例请求

  • “开启 Image Gen,为背包做一个银钥匙图标。”
  • “用本地图像模型画一张沙漠峡谷的概念图。”
  • “做一个 5 秒的标题画面片段,带风声和远处的雷声。”

一个队列,一块 GPU

图像和片段共用同一个队列和同一块 GPU,同一时间只加载一个模型。加载模型需要一些时间,所以只要还有任务在等待,已加载的模型就会一直占用 GPU,图像和片段都一样。当已加载的模型没有待办任务,或者针对另一个模型的任务已等待至少 5 分钟时,另一个模型才能轮到自己。此时,下一个轮到的就是任务等待时间最长的模型。切换模型绝不会中断已经在运行的图像或片段:它会先完成。只有在你停止它、达到你设置的生成时间上限,或者智能体取消片段时,它才会提前停止。

下载内容

一个上游发布版本,按 tag 固定并通过 sha256 校验:leejet/stable-diffusion.cpp master-1106-532d2c1。Linux 变体仍停留在 master-929-3f8527a:上游从该版本起在 Ubuntu 26.04 上构建 Linux,而那些二进制文件需要 glibc 2.43。应用会为你的电脑选择一个变体。你可以通过 backend 设置更改它。

变体电脑下载
win-x64-cuda12Windows,NVIDIA GPU(驱动 572.61 或更新,计算能力 6.1 或更新)976 MB(程序 + NVIDIA CUDA 运行时)
win-x64-vulkanWindows,AMD / Intel / 其他 GPU30 MB
win-x64-cpu没有可用 GPU 的 Windows:使用处理器。速度慢(在性能较好的台式机上,每张 512 px 图像约需一分钟,笔记本上需要数分钟),且仅适用于在该硬件上测量过的模型(Qwen-Image-2.1 Turbo)18 MB
darwin-arm64-metalApple 芯片 Mac,macOS 26 或更新38 MB
linux-x64-vulkan带 Vulkan GPU 的 Linux x64,glibc 2.38 或更新(Ubuntu 24.04+、Debian 13+)。需要安装 libgomp.so.1 和 libvulkan.so.137 MB

在 GPU 构建可运行的环境里绝不会选用 CPU 构建;如果仍要使用,可在 Models 中把后端选为 CPU。

文本编码器。 模型中负责读取提示词的部分可以运行在 GPU 或处理器上(textEncoder 设置,Models 中的 Text encoder)。Auto 保持每个模型测量时的配置:Qwen-Image-2.1 Turbo Q3 和 Wan 2.2 为适配其显卡而把它放在处理器上。CPU 可释放约 2 GB 显存,代价是每张图像多花一两秒;GPU 在显卡有余量时略快,但对于测量时把它放在处理器上的模型,可能会显存不足。

Linux 是预览版。 Linux 构建尚未在真实的 Linux GPU 上测试过。它可以选择,并标记为“预览”。

应用从不安装驱动或系统库。如果有缺失,它会告诉你需要安装什么。

许可证

  • stable-diffusion.cpp — MIT,© leejet(许可证)。
  • ggml — MIT(上游附带的是 ggml-org/ggml 的分支 leejet/ggml)。
  • NVIDIA CUDA 运行时(cudart、cuBLAS),仅包含在 Windows CUDA 变体中 — 由上游依据 NVIDIA CUDA EULA 再分发。
  • NVIDIA CUTLASS,仅包含在 Windows CUDA 变体中 — BSD-3-Clause(许可证)。
  • 本包 — MIT。每个模型包都会说明自己的许可证。

所有文件均从上游 GitHub 发布页下载。AI Game Dev 不托管这些文件。

版本

本地图像和视频生成 的发布版本
版本发布时间需要应用
1.3.1最新0.20.0 或更高版本
1.3.00.20.0 或更高版本
1.2.00.20.0 或更高版本
1.1.30.20.0 或更高版本
1.1.20.20.0 或更高版本
1.1.10.20.0 或更高版本
1.1.00.20.0 或更高版本
1.0.10.20.0 或更高版本
1.0.00.20.0 或更高版本

安装

在桌面应用中安装

打开包窗口(状态栏中的包图标),选择浏览,搜索 aigd.sdcpp,然后点击添加到项目。

还没安装应用?免费下载 AI Game Dev,支持 Windows、macOS 和 Linux。

从终端安装

在项目文件夹中使用 gamedev CLI:

gamedev pkg add aigd.sdcpp

环境要求

  • AI Game Dev 0.20.0 或更高版本
  • 搭载 Apple 芯片的 Mac

进一步了解包

安装
gamedev pkg add aigd.sdcpp