本地音效与音乐(Stable Audio 3)
gamedev pkg add aigd.sa3cpp概览
在 AI Game Dev 中本地生成音效与音乐的运行时,基于 sa3.cpp(Stable Audio 3 的 C++/ggml 移植版),可在 CUDA、Vulkan、Metal 或 CPU 上运行,无需 Python。它可运行 Stable Audio 3 Small SFX、Small Music 和 Medium 模型,这些模型是独立的包。
本地音效与音乐是一个运行时,让 AI Game Dev 应用借助 Stable Audio 3 模型在你自己的电脑上生成音效和器乐音乐。它使用 sa3.cpp,这是 Stability AI 的 Stable Audio 3 的 C++/ggml 移植版,无需 Python。所有内容都在你的电脑上生成,生成过程不产生任何费用。它适合那些想要音效、拟音、UI 音效和背景音乐、又不想依赖云服务的游戏开发者。
功能
- 下载适合你电脑的 sa3.cpp 发行版(Windows、Apple 芯片的 Mac,以及作为预览的 Intel Mac 和 Linux;CUDA、Vulkan、Metal 或 CPU),用 sha256 校验后运行。
- 在会话的 Tools 栏中添加 SFX & Music 开关。除非你在会话中打开它,否则该开关一直处于关闭状态。
- 每个音效运行一次
sa3-generate,不保留常驻服务。
本包只包含数据(aigd-package.json,无代码)。它告诉 AI Game Dev 该为你的电脑下载哪个 sa3.cpp 发行版。程序本身由应用负责下载、校验和运行。
模型是独立的包
本包不含任何模型。先从 Packages 浏览器安装模型包,再到 Models 面板下载其文件:
| 包 | 生成内容 |
|---|---|
Stable Audio 3 Small SFX(aigd.audio-stable-audio-3-small-sfx) | 音效与拟音,最长 60 秒 |
Stable Audio 3 Small Music(aigd.audio-stable-audio-3-small-music) | 器乐音乐,最长 2 分钟 |
Stable Audio 3 Medium(aigd.audio-stable-audio-3-medium) | 器乐音乐,最长 6 分 20 秒 |
未经你确认,不会下载任何内容。你会先看到文件大小和模型许可证。Stable Audio 3 模型有自己的许可证,其中包含收入上限、注册义务和 "Powered by Stability AI" 声明。每个模型包的 README 都写明了这些条款。
其他本地音乐、音效和语音模型通过 Local audio generation(aigd.audiocpp)运行。
示例请求
打开 SFX & Music 并安装好模型后,你就可以用大白话向智能体提要求:
- “给玩家的枪做一个简短的激光射击音效。”
- “生成踩在雪地上的脚步声,4 秒。”
- “为主菜单做一段 90 秒的轻松 lo-fi 器乐。”
下载内容
应用下载的是上游发行版,按 tag 固定并用 sha256 校验:betweentwomidnights/sa3.cpp v0.2.4(commit 3152253)。上游将其标记为预发布版。应用会为你的电脑选择其中一个变体。
| 变体 | 电脑 | 下载 |
|---|---|---|
win-x64-cuda12 | Windows,NVIDIA GPU(驱动 572.61 或更高版本,计算能力 6.1 或更高) | 752 MB(程序 + NVIDIA CUDA 12.8 运行时) |
win-x64-vulkan | Windows,AMD / Intel / 其他 GPU | 19 MB(核心 + Vulkan 后端) |
win-x64-cpu | Windows,无可用 GPU(速度慢;Medium 需要 GPU) | 7 MB |
darwin-arm64-metal | Apple 芯片 Mac,macOS 13.3 或更高版本 | 11 MB(由上游签名并公证) |
darwin-x64-cpu | Intel Mac,macOS 13.3 或更高版本(仅 CPU) | 11 MB |
linux-x64-vulkan | Linux x64,配有 Vulkan GPU,glibc 2.38 或更高版本(Ubuntu 24.04+、Debian 13+)。需要 libgomp.so.1 和 libvulkan.so.1 | 22 MB |
linux-x64-cpu | Linux x64,无可用 GPU,glibc 2.38 或更高版本。需要 libgomp.so.1 | 12 MB |
Windows CUDA 变体使用上游的独立压缩包,它是唯一包含 CUDA 运行时的压缩包(cudart64_12、cublas64_12、cublasLt64_12)。拆分版 cuda 压缩包只包含 ggml-cuda.dll,并要求系统范围内安装 CUDA 12.8 运行时。
预览版。 Linux 和 Intel Mac 变体尚未在真实硬件上测试,上游也未验证 CPU 生成。它们可以被选择,并标记为“预览”。
应用从不安装驱动或系统库。如果有缺失,它会告诉你需要安装什么。
许可证
- sa3.cpp — MIT,© 2026 betweentwomidnights(许可证)。
- ggml — MIT,© The ggml authors(ggml-org/ggml)。
- cpp-httplib(MIT,© yhirose)、yyjson(MIT,© YaoYuan)、Signalsmith Stretch 和 Signalsmith Linear(MIT,© Signalsmith Audio)。它们的许可证文件随压缩包一同分发。
- RoyalCities RC-stable-audio-tools 提示词引擎(MIT,© 2023 Stability AI),改编自
sat-*工具(源码)。AI Game Dev 不运行这些工具;许可证位于压缩包的THIRD_PARTY_NOTICES.md中。 - Microsoft Visual C++ 运行时(
msvcp140、vcruntime140、vcruntime140_1、vcomp140),仅存在于 Windows 变体中。上游依据 Visual Studio 2022 可分发代码条款重新分发它。 - NVIDIA CUDA 运行时(cudart、cuBLAS),仅存在于 Windows CUDA 变体中。上游依据 NVIDIA CUDA EULA 重新分发它,
NVIDIA-CUDA-EULA.txt随压缩包一同提供。 - 本包 — MIT。运行时不含任何模型权重。每个模型包都声明自己的许可证。
所有文件均从上游 GitHub 发行版下载。AI Game Dev 不托管这些文件。
版本
| 版本 | 发布时间 | 需要应用 |
|---|---|---|
| 1.0.2最新 | 0.32.0-beta.6 或更高版本 | |
| 1.0.1 | 0.32.0-beta.6 或更高版本 |
安装
在桌面应用中安装
打开包窗口(状态栏中的包图标),选择浏览,搜索 aigd.sa3cpp,然后点击添加到项目。
还没安装应用?免费下载 AI Game Dev,支持 Windows、macOS 和 Linux。
从终端安装
在项目文件夹中使用 gamedev CLI:
gamedev pkg add aigd.sa3cpp环境要求
- AI Game Dev 0.32.0-beta.6 或更高版本
gamedev pkg add aigd.sa3cpp