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

## 安装

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

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

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.cloud-ace-step`，然后点击 **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
# ACE-Step — 云端音频（`aigd.cloud-ace-step`）

ACE Studio 开源的 ACE-Step 1.5 音乐模型的云端版本，由 AI Game Dev 智能体运行。它根据风格提示词生成音乐，时长从 10 秒到 4 分钟，并且处于云端音乐模型的最低用量档，因此是用你的额度来勾勒一段配乐草稿最轻量的方式。适合关卡音乐草稿、在构建版本中试听的曲目，以及较长的背景音乐。会消耗你的 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 为一段芯片音乐风格的 Boss 主题制作三个 30 秒的草稿。”

## 变体

| 变体 | 名称 | 生成内容 | 限制 | 计费单位 |
|---|---|---|---|---|
| `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。
````
