# Audio Music Generate

> 生成无人声、无歌词的纯音乐 / BGM，适合背景音乐、氛围铺垫、情绪渲染，时长 30–120 秒。仅在用户明确要求生成纯音乐/背景音乐时触发。执行时会读取 Meitu 凭证、调用本地 `meitu` CLI，并把音频生成请求发送到 Meitu OpenAPI，结果写入本地输出目录。

- **Type:** Skill
- **Install:** `agentstack add skill-meitu-meitu-skills-audio-music-generate`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [meitu](https://agentstack.voostack.com/s/meitu)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [meitu](https://github.com/meitu)
- **Source:** https://github.com/meitu/meitu-skills/tree/main/skills/audio-music-generate

## Install

```sh
agentstack add skill-meitu-meitu-skills-audio-music-generate
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Audio Music Generate

## Overview

纯音乐/BGM 生成（无人声、无歌词），支持多种风格（爵士/古典/电子/钢琴/氛围等）和时长精确控制（30–120 秒）。偏氛围/铺垫/背景类纯音乐，不负责强节奏强变化或完整歌曲结构。

执行前应让用户清楚知道：本 Skill 会使用 Meitu OpenAPI 凭证、调用本地 `meitu` CLI、将生成请求发送到 Meitu OpenAPI，并把生成的音频文件写入 `./output/` 或 `$VISUAL/output/audio-music-generate/`。

## API Mapping

- 纯音乐/BGM 生成：`audio_peanut_generate`

## Dependencies

- **meitu-cli**: `>=2.0.6`
- **凭证**：CONFIG AKSK → `meitu tools update`；EXEC AKSK → 实际执行（见根 `CONFIG.md`）
- **环境变量**：`MEITU_OPENAPI_TOOL_TASK_MODE=command`

> 路径别名：`$VISUAL` = `{OPENCLAW_HOME}/workspace/visual/`

## Core Workflow

```
Preflight → Execute → Deliver
```

### Preflight

1. `meitu --version` ≥ 2.0.6
2. 已用 CONFIG AKSK 跑过 `meitu tools update`
3. 当前 AKSK = EXEC，`MEITU_OPENAPI_TOOL_TASK_MODE=command`
4. output_dir：openclaw.yaml → `./output/` ｜else → `$VISUAL/output/audio-music-generate/`；`mkdir -p`

### Execute

**触发信号 / 路由规则**

核心维度：**纯音乐场景命中 + 参数齐全**。

| 场景 | 判定关键词 | 路由 |
|------|----------|------|
| 纯音乐 / BGM / 背景音乐 | 明确要求生成 BGM、纯音乐、无人声背景音乐 | `audio_peanut_generate` |

单 API 工具：参数齐全即调用，失败重试 1 次后返回错误；不做跨工具兜底。

**参数定义**

| 参数 | 类型 | 必填 | 范围 | 默认 | 说明 |
|------|------|------|------|------|------|
| `prompt` | STRING | 是 | -- | -- | 纯音乐描述（主题/风格/场景/情绪）。缺失 → 提示"请描述你想要的音乐风格或场景" |
| `duration` | NUMBER | 是 | 30–120 | 30 | 生成时长（秒）。超出范围自动钳位至 30–120，并告知用户 |

`prompt` 由 Agent 整理为结构化的风格/场景/情绪描述。

**工具调用**

```bash
meitu audio-music-generate --prompt "" [--duration 30] --json --download-dir {output_dir} --skill_name skill_audio-music-generate
```

**错误降级**

| 场景 | 处理方式 |
|------|------|
| `prompt` 缺失 | 提示"请描述你想要的音乐风格或场景"，不调用 API |
| `duration` 超出 30–120 | 自动钳位，告知用户 |
| 用户要求 >120s | 告知最长 120s，钳位 |
| `audio_peanut_generate` 调用失败 | 重试 1 次，仍失败返回错误 |
| 风格描述模糊 | 提示补充风格/场景/情绪偏好 |
| 内容合规拦截 | 直接返回合规提示，不重试 |

### Deliver

- 使用 Preflight 解析的 output_dir
- 从 `downloaded_files[0].saved_path` 读取已下载音频文件路径
- `mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_audio-music-generate.mp3`

## Output

- **格式**：MP3
- **位置**：项目 → `./output/`，一次性 → `$VISUAL/output/audio-music-generate/`

## 基线 Task ID

见 `references/task-id-baseline.md` 中对应行。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [meitu](https://github.com/meitu)
- **Source:** [meitu/meitu-skills](https://github.com/meitu/meitu-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-meitu-meitu-skills-audio-music-generate
- Seller: https://agentstack.voostack.com/s/meitu
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.