meitu 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
meitu --version≥ 2.0.6- 已用 CONFIG AKSK 跑过
meitu tools update - 当前 AKSK = EXEC，
MEITU_OPENAPI_TOOL_TASK_MODE=command - 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。人声质量受多语言发音影响。
工具调用
meitu audio-song-generate --prompt "<style>" --prompt_lyrics "<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 中对应行。