# Lyria（雲端音訊）

> Google Lyria 3 雲端音樂：依文字描述製作 30 秒片段，可為純樂器或含人聲，適合遊戲選單主題曲、關卡音樂草稿與預告片配樂。會使用你的額度。

- ID: `aigd.cloud-lyria`
- 來源: 官方 (第一方 `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-lyria

## 安裝

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

```bash
gamedev pkg add aigd.cloud-lyria
```

在桌面應用程式中：開啟「套件」視窗（狀態列上的套件圖示），選擇 **瀏覽**，搜尋 `aigd.cloud-lyria`，然後點 **加入專案**。更多資訊：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
# Lyria — 雲端音訊（`aigd.cloud-lyria`）

Google 的 Lyria 3 音樂模型位於雲端，由 AI Game Dev 代理程式執行。它會依最多 2000 字的文字描述，製作 30 秒的音樂片段，可為純樂器或含人聲。適合選單主題曲、關卡與生態域音樂草稿、轉場音效與預告片配樂。會使用你的 AI Game Dev 方案額度；不需要 Google 帳號或 API 金鑰。

## 你可以做什麼

- 為選單、關卡、生態域或頭目戰草擬主題曲。
- 為同一個場景嘗試幾種情緒（平靜、緊張、凱旋），再互相比較。
- 為預告片、商店頁面影片或社群短片製作 30 秒的配樂底。
- 在提示詞中描述曲風、情緒、樂器與節奏，引導生成結果。

## 範例請求

- 「為主要選單做一段 30 秒的 Lyria 樂曲：管弦奇幻、充滿希望、緩慢堆疊。」
- 「用 Lyria 產生三個沙漠關卡主題曲版本：烏德琴與打擊樂器、中速，每個版本情緒不同。」
- 「用 Lyria 為追逐橋段做一段緊張的 synthwave 樂曲。」

## 變體

| 變體 | 名稱 | 產出 | 限制 | 預估單位 |
|---|---|---|---|---|
| `lyria-3` | Lyria 3 | 音樂 | 30 秒；提示詞最多 2000 字元 | 每段片段 |

每段片段都是 30 秒，且無法指定種子。應用程式的音訊工具不會為雲端音樂另外接受歌詞：請在提示詞中描述你想要的內容。

若需要更長的樂曲，[ACE-Step](https://ai-game.dev/packages/aigd.cloud-ace-step) 可在雲端製作最多 240 秒的內容。

## 運作方式

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

伺服器 id（`/api/media` 的 `package_id`，即其媒體模型 id）：`aigd.cloud.lyria`。

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

## 授權

模型：專有。生成的音訊可在供應商針對該變體的條款下供你使用。此套件僅含資料（不含程式碼），Apache-2.0。
````
