# ACE-Step（雲端音訊）

> 雲端版 ACE-Step 1.5：依風格提示詞生成開放音樂，長度 10 秒到 4 分鐘，是你額度中最輕量的雲端音樂模型，適合草擬遊戲配樂。會使用你的額度；同一個模型也能在本機執行。

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

## 安裝

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

```bash
gamedev pkg add aigd.cloud-ace-step
```

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

## 版本

| 版本 | 發佈日期 | 需要應用程式 | 備註 |
|---|---|---|---|
| 0.1.4 | 2026-11-22 | `>=0.25.11` | 最新 |
| 0.1.3 | 2026-11-18 | `>=0.25.11` | - |
| 0.1.2 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.1 | 2026-11-01 | `>=0.25.11` | - |

## 說明

````markdown
# ACE-Step — 雲端音訊（`aigd.cloud-ace-step`）

ACE Studio 的開放 ACE-Step 1.5 音樂模型在雲端執行，由 AI Game Dev 代理操作。它會依風格提示詞生成音樂，長度從 10 秒到 4 分鐘，屬於雲端音樂模型中用量層級最低者，因此是你額度內草擬曲目最輕量的方式。適合關卡配樂草稿、在 build 中試聽的曲目，以及較長的背景音樂。會使用你的 AI Game Dev 方案額度；同一個模型也能以 [ACE-Step 1.5 套件](https://ai-game.dev/packages/aigd.audio-ace-step-1-5) 在本機執行。

## 你可以做什麼

- 為關卡、樞紐區或選單草擬背景音樂。
- 製作較長的樂曲（最長 240 秒），用於探索與氛圍場景。
- 嘗試多種風格，留下最合適的那一個。
- 用種子重現結果。

## 範例請求

- 「用 ACE-Step 做一首 60 秒的森林關卡曲目：木吉他、長笛，平靜而溫暖。」
- 「用 ACE-Step 為太空站樞紐生成一段 2 分鐘的氛圍音樂。」
- 「用不同的種子，讓 ACE-Step 做出三份 30 秒的 chiptune 頭目主題草稿。」

## 變體

| 變體 | 名稱 | 生成內容 | 限制 | 估計單位 |
|---|---|---|---|---|
| `ace-step-1-5` | ACE-Step 1.5 | 音樂 | 10、30、60、120、240 秒；提示詞最多 500 個字元 | 每生成一秒 |

預設長度為 30 秒。可接受種子（相同的種子與提示詞會得到相似的結果）。

歌詞：雲端變體不接受歌詞，因此請在提示詞中描述風格（曲風、情緒、樂器、速度）。若要用自己的歌詞製作歌曲，請在你的 GPU 上使用本機的 [ACE-Step 1.5](https://ai-game.dev/packages/aigd.audio-ace-step-1-5) 套件，它不會用到你的額度。

## 運作方式

透過 [雲端生成](https://ai-game.dev/packages/aigd.cloud-media)（`aigd.cloud-media`，在每個對話中預設開啟）執行：當任務合適，或當你指名時，代理會選用這個模型。在對話生成預算內的工作會直接執行而不詢問（*每次操作前詢問* 則會逐一詢問）。估計值為每生成一秒占你額度的百分比，失敗的工作不計入你的額度。你的方案能否使用取決於你的帳號（模型分頁，`audio_list_models`）；方案無法使用的變體會顯示為鎖定。檔案會以 MP3 或 WAV 儲存到你的專案中，且絕不會覆寫既有檔案。

伺服器 id（`/api/media` 的`package_id`，也就是它的媒體模型 id）：`aigd.cloud.ace-step`。

變體、模式與限制都來自伺服器的目錄（capabilities v2 中的 `aigd.cloud.ace-step`；`packages/core/test/cloud-media-manifests.test.ts` 會讓這個套件與其保持一致）。伺服器只有在變體的供應商路由與額度使用方式都驗證完成後，才會執行該變體；規劃中的變體會列為「即將推出」。

## 授權

模型：MIT（開放權重）。生成的音訊歸你使用，但須遵守該變體的供應商條款。本套件僅含資料（不含程式碼），Apache-2.0。
````
