# Audio Song Generate

> 歌词驱动的完整歌曲生成（含人声），也支持强节奏成品级纯音乐。仅当用户明确要求生成歌曲/音频成品，并提供或同意补充风格与歌词参数时触发；普通音乐讨论、歌词创作、闲聊式演唱请求不触发。

- **Type:** Skill
- **Install:** `agentstack add skill-meitu-meitu-skills-audio-song-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-song-generate

## Install

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

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

## About

# Audio Song Generate

## Overview

歌词驱动的完整歌曲生成（含人声，主歌/桥段/合唱完整结构），多风格创作（流行/古风/电子/摇滚等）。也支持强节奏 / 完整编曲感的纯音乐，编曲能力优于通用纯音乐工具。

## API Mapping

- 歌曲与强节奏纯音乐生成：`audio_cashew_songgenerate`

## 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-song-generate/`；`mkdir -p`

### Execute

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

核心维度：**人声/编曲场景命中 + 参数齐全**。

| 场景 | 判定关键词 | 路由 |
|------|----------|------|
| 含人声的完整歌曲 | 写首歌、带人声、带歌词、唱一首、品牌歌曲 | `audio_cashew_songgenerate` |
| 强节奏 / 完整编曲的纯音乐 | 强节奏、强变化、反转旋律、完整编曲感 | `audio_cashew_songgenerate` |

单 API 工具：参数齐全即调用，失败重试 1 次后返回错误；不做跨工具兜底。风格与歌词矛盾时以 `prompt`（风格）为准。

**参数定义**

| 参数 | 类型 | 必填 | 范围 | 默认 | 说明 |
|------|------|------|------|------|------|
| `prompt` | STRING | 是 | -- | -- | 歌曲风格描述。缺失 → 提示"请描述你想要的歌曲风格" |
| `prompt_lyrics` | STRING | 是 | -- | -- | 歌词内容。缺失 → 提示"请提供歌词内容"（强节奏纯音乐场景可填空字符串或风格化描述） |
| `model` | STRING | 否 | auto / mureka-6 / mureka-7.5 / mureka-o1 | auto | 生成模型选择，非法值回退 auto |

`audio_cashew_songgenerate` 使用 `prompt + prompt_lyrics + model`。人声质量受多语言发音影响。

**工具调用**

```bash
meitu audio-song-generate --prompt "" --prompt_lyrics "" [--model auto] --json --download-dir {output_dir} --skill_name skill_audio-song-generate
```

**错误降级**

| 场景 | 处理方式 |
|------|------|
| `prompt` 缺失 | 提示"请描述你想要的歌曲风格"，不调用 API |
| `prompt_lyrics` 缺失（含人声场景） | 提示"请提供歌词内容"，不调用 API |
| `model` 指定了不存在的值 | 回退 `auto` |
| `audio_cashew_songgenerate` 调用失败 | 重试 1 次，仍失败返回错误 |
| `prompt` 与 `prompt_lyrics` 风格矛盾 | 以 `prompt` 为准，告知用户歌词将按指定风格编曲 |
| 用户只要歌词不要旋律 | 拒绝，不属于本工具范围 |
| 内容合规拦截 | 直接返回合规提示，不重试 |

### Deliver

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

## Output

- **格式**：MP3
- **位置**：项目 → `./output/`，一次性 → `$VISUAL/output/audio-song-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-song-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%.