# ElevenLabs（雲端音訊）

> 雲端 ElevenLabs 遊戲音訊：以 21 種聲音（v4 Turbo 與 Eleven v4）製作對白與旁白的語音，並可依描述生成 1 至 30 秒的音效；音樂即將推出。會使用你的額度。

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

## 安裝

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

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

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

## 版本

| 版本 | 發佈日期 | 需要應用程式 | 備註 |
|---|---|---|---|
| 0.1.5 | 2026-11-22 | `>=0.25.11` | 最新 |
| 0.1.4 | 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
# ElevenLabs — 雲端音訊（`aigd.cloud-elevenlabs`）

由 AI Game Dev 代理在雲端執行 ElevenLabs：為遊戲音訊提供語音與音效，音樂也即將推出。兩種語音變體能以 21 種聲音之一朗讀你的台詞，Sound Effects 3 則可依描述製作 1 至 30 秒的音效。適合用在原型與遊戲版本中的對白、旁白、短句語音、UI 音效與環境音。會使用你 AI Game Dev 方案的額度；不需要 ElevenLabs 帳號或 API 金鑰。

## 你可以做什麼

- 為 NPC 對白、任務文字、教學與旁白配音。
- 製作佔位或最終的短句語音（「重新裝彈！」、「這邊！」）供遊玩測試使用。
- 為 UI、武器、腳步、門、魔法與環境音生成音效。
- 從 21 種具名聲音中為每個角色挑選聲音。
- Music v2.5 已列出，即將推出。

## 範例請求

- 「用 ElevenLabs 為這五句店員台詞配音，聲音用 Charlotte，並存到專案裡。」
- 「用 ElevenLabs v4、George 的聲音朗讀開場旁白。」
- 「用 ElevenLabs 做一段 3 秒的音效：厚重的木門嘎吱打開。」
- 「用 Sound Effects 3 生成 10 秒的洞穴風聲環境音。」

## 變體

| 變體 | 名稱 | 製作 | 限制 | 估算單位 |
|---|---|---|---|---|
| `elevenlabs-v4-turbo` | v4 Turbo | 語音 | 21 種聲音，最多 5000 字元 | 每 1000 字元 |
| `elevenlabs-v4` | Eleven v4 | 語音 | 21 種聲音，最多 5000 字元 | 每 1000 字元 |
| `elevenlabs-sfx-3` | Sound Effects 3 | 音效 | 1、2、3、5、10、15、22、30 秒；提示最多 500 字元 | 每秒生成 |
| `elevenlabs-music-2-5` | Music v2.5（即將推出） | 音樂 | 60、120、180 秒；提示最多 2000 字元 | 每秒生成 |

聲音（兩種語音變體皆同）：Rachel（預設）、Aria、Roger、Sarah、Laura、Charlie、George、Callum、River、Liam、Charlotte、Alice、Matilda、Will、Jessica、Eric、Chris、Brian、Daniel、Lily、Bill。

Sound Effects 3 預設製作 3 秒。v4 Turbo 是此系列的預設變體。這些變體都不接受 seed。

### 如何選擇

- **v4 Turbo** —— 預設的語音變體，額度用量比 Eleven v4 低。
- **Eleven v4** —— 此系列中語音品質最高的等級；每 1000 字元會用掉更多額度。
- **Sound Effects 3** —— 任何非語音的聲音，從短促的 UI 點擊聲到 30 秒的環境音。
- **Music v2.5** —— 尚無法使用；目前要製作音樂，請見 [Lyria](https://ai-game.dev/packages/aigd.cloud-lyria) 或 [ACE-Step](https://ai-game.dev/packages/aigd.cloud-ace-step)。

## 運作方式

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

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

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

## 授權

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