# MOSS-SoundEffect v2（音效模型）

> OpenMOSS 的 MOSS-SoundEffect v2：依英文或中文描述生成音效與環境氛圍（自然、城市、生物、人類動作），1 至 30 秒，48 kHz 單聲道，適合遊戲關卡與場景。透過 audio.cpp 在你的 GPU 上本機執行。Apache-2.0（依模型卡標示），允許商業使用。

- ID: `aigd.audio-moss-soundeffect-v2`
- 來源: 官方 (第一方 `aigd.*`)
- 分類: 音訊
- 發佈者: AI Game Dev (`aigd`), 已驗證
- 最新版本: 1.0.2 (發佈於 2026-11-22)
- 授權條款: SEE LICENSE IN README.md
- 需要 AI Game Dev 應用程式: `>=0.32.0-beta.6`
- 原生程式碼: 否
- 評分: 尚無評分
- HTML 頁面: https://ai-game.dev/zh-hant/packages/aigd.audio-moss-soundeffect-v2

## 安裝

在專案資料夾中，使用 gamedev CLI：

```bash
gamedev pkg add aigd.audio-moss-soundeffect-v2
```

在桌面應用程式中：開啟「套件」視窗（狀態列上的套件圖示），選擇 **瀏覽**，搜尋 `aigd.audio-moss-soundeffect-v2`，然後點 **加入專案**。更多資訊：https://ai-game.dev/docs/wiki/app/packages

## 版本

| 版本 | 發佈日期 | 需要應用程式 | 備註 |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0-beta.6` | 最新 |
| 1.0.1 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## 說明

````markdown
# MOSS-SoundEffect v2 (`aigd.audio-moss-soundeffect-v2`)

MOSS-SoundEffect v2.0 是 OpenMOSS 團隊於 2026-05-26 發布的音效模型。它能依英文或中文描述生成環境氛圍、自然、城市、生物與人類動作的聲音：1 至 30 秒的 48 kHz 單聲道音訊。在 AI Game Dev 應用程式中，它透過 **本機音訊生成**（`aigd.audiocpp`，audio.cpp 執行環境）在你的 GPU 上本機執行，因此每個音效都不需任何費用。它適合需要環境音與生物或角色音效的遊戲開發者，授權為 Apache-2.0（依發行者標示），允許商業使用。

## 你可以製作的內容

- 關卡的環境氛圍底層，例如森林、雨聲或熱鬧的街道。
- 開放世界與城市用的自然環境與都市場景。
- 動物與生物音效，例如狗吠或魔物低吼。
- 人類動作，例如腳步聲或開門聲。

若需要短促的撞擊聲、UI 音效與立體聲擬音，另請參閱 [Stable Audio 3 Small SFX](https://ai-game.dev/packages/aigd.audio-stable-audio-3-small-sfx)。

## 範例請求

- 「製作 30 秒的夜晚森林氛圍，要有蟋蟀聲和遠處的貓頭鷹叫聲。」
- 「生成低沉的魔物低吼，約 3 秒。」
- 「製作踩在濕礫石上的腳步聲，5 秒，不要音樂。」
- 「為城鎮廣場製作熱鬧的中世紀市集人群氛圍。」

## 重點特色

| 規格 | 數值 |
|---|---|
| 輸出 | 48 kHz 單聲道 WAV，儲存到你的專案中 |
| 長度 | 1 至 30 秒（預設 10 秒） |
| 輸入 | 英文或中文描述，最多 1,000 個字元 |
| 負向提示詞 | 描述要避免的內容，最多 1,000 個字元（選填） |
| 步數 | 預設 100，最多 200 |
| 引導強度 | 預設 4 |
| 種子 | 預設 0；相同種子可重現相同結果 |

此套件僅含資料。它指名一個檔案。在你確認之後，應用程式會下載該檔案、以 sha256 檢查，並在你的電腦上以 audio.cpp 執行。

## 下載

4.00 GB，單一檔案，固定於 Hugging Face 的提交 `b7b9aa1f`：

| 檔案 | 來源 | 大小 |
|---|---|---:|
| `moss-soundeffect-v2-q8_0.gguf`（Qwen3 文字編碼器、DiT 與 DAC 解碼器整合於單一檔案） | [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf/tree/b7b9aa1f16c819c3b2d69a602b51786bdfb361a3/MOSS-SoundEffect-v2-GGUF) | 4.00 GB |

由 [`OpenMOSS-Team/MOSS-SoundEffect-v2.0`](https://huggingface.co/OpenMOSS-Team/MOSS-SoundEffect-v2.0/tree/e35df4d82fbe87fcd5d14e5d100e349c0c3c076d) 於 `e35df4d` 轉換而來。

## 適用電腦

| 電腦 | 需求 | 速度 |
|---|---|---|
| NVIDIA GPU (CUDA) | 約 10 GB 的 GPU 記憶體（上游：峰值 8.6 GiB） | 約為即時（RTX 5090 上 RTF 0.85，上游數據） |
| 其他 GPU（Vulkan） | 約 10 GB（估計） | 尚未實測 |
| Apple 晶片 Mac（Metal） | 約 16 GB 記憶體（估計） | 尚未實測 |

每次請求都會執行模型完整的 30 秒視窗，因此短音效與長音效所需時間差不多。

## 授權

Apache-2.0，**依發行者標示**。允許商業使用。

- MOSS-SoundEffect v2.0 © OpenMOSS 團隊 — [模型卡](https://huggingface.co/OpenMOSS-Team/MOSS-SoundEffect-v2.0)（`license: apache-2.0`）。模型儲存庫**沒有 LICENSE 檔案**：授權僅述於模型卡的標籤中。Apache-2.0 條文位於 [OpenMOSS/MOSS-TTS 程式碼儲存庫](https://github.com/OpenMOSS/MOSS-TTS/blob/main/LICENSE)。
- 文字編碼器是 Qwen3 模型（Apache-2.0），封裝在 GGUF 檔案內。
- GGUF 轉換由 audio.cpp 完成 — [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf)，Apache-2.0。

重新散布權重時必須標註：Apache-2.0 授權條文與聲明。

限制說明：除授權條文中的聲明外並無其他限制；缺少 LICENSE 檔案是唯一的注意事項。

所有檔案皆從 Hugging Face 下載。AI Game Dev 不自行託管這些檔案。
````
