meitu 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
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-music-generate/；mkdir -p
Execute
触发信号 / 路由规则
核心维度：纯音乐场景命中 + 参数齐全。
| 场景 | 判定关键词 | 路由 |
|---|---|---|
| 纯音乐 / BGM / 背景音乐 | 明确要求生成 BGM、纯音乐、无人声背景音乐 | audio_peanut_generate |
单 API 工具：参数齐全即调用，失败重试 1 次后返回错误；不做跨工具兜底。
参数定义
| 参数 | 类型 | 必填 | 范围 | 默认 | 说明 |
|---|---|---|---|---|---|
prompt |
STRING | 是 | -- | -- | 纯音乐描述（主题/风格/场景/情绪）。缺失 → 提示"请描述你想要的音乐风格或场景" |
duration |
NUMBER | 是 | 30–120 | 30 | 生成时长（秒）。超出范围自动钳位至 30–120，并告知用户 |
prompt 由 Agent 整理为结构化的风格/场景/情绪描述。
工具调用
meitu audio-music-generate --prompt "<style/scene/mood>" [--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 中对应行。