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

## 安装

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

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

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

## 你可以做什么

- 为菜单、关卡、生物群系或 Boss 战勾勒一段主题音乐。
- 为同一个场景尝试几种情绪（平静、紧张、凯旋），然后对比。
- 为预告片、商店页面视频或社交短片制作 30 秒的配乐铺底。
- 在提示词中描述曲风、情绪、乐器和速度，以此引导生成结果。

## 示例请求

- “用 Lyria 为主菜单做一首 30 秒的曲子：管弦奇幻风，充满希望，缓慢推进。”
- “用 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。
````
