# 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-hans/packages/aigd.cloud-elevenlabs

## 安装

使用 gamedev CLI，在项目文件夹中运行：

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

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.cloud-elevenlabs`，然后点击 **Add to Project**。更多：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`）

云端 ElevenLabs，由 AI Game Dev 的 agent 运行：为游戏音频提供语音和音效，音乐即将推出。两种语音变体可用 21 种音色之一朗读你的台词，Sound Effects 3 则根据描述生成 1 至 30 秒的音效。适合原型和正式版本中的对白、旁白、短促台词、UI 音效和环境音。使用你的 AI Game Dev 方案额度；无需 ElevenLabs 账号或 API key。

## 你可以做什么

- 为 NPC 对白、任务文本、教程和旁白配音。
- 制作占位或最终版的短促台词（“Reloading!”、“Over here!”），用于试玩测试。
- 为 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)。

## 运行方式

通过[云端生成](https://ai-game.dev/packages/aigd.cloud-media)（`aigd.cloud-media`，在每个对话中默认开启）运行：当任务合适，或当你点名它时，agent 会选用此模型。在对话生成预算内的任务无需询问即可运行（*每次操作前询问*会逐个询问）。估算值是你额度的一个百分比，失败的任务不计入你的额度。你的方案可以使用哪些变体由账户决定（模型标签页，`audio_list_models`）；方案无法使用的变体会显示为锁定。文件以 MP3 或 WAV 保存到你的项目中，绝不会覆盖已有文件。

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

变体、模式和限制来自服务器的目录（capabilities v2 中的 `aigd.cloud.elevenlabs`；`packages/core/test/cloud-media-manifests.test.ts` 会让此包与其保持一致）。服务器只有在变体的提供商路由和额度消耗都验证通过后才会运行该变体；计划中的变体会列为“Coming soon”。

## 许可

模型：专有。生成的音频归你使用，须遵守提供商针对该变体的条款。本包仅包含数据（不含代码），Apache-2.0。
````
