audio-song-generate — meitu/meitu-skills Agent…

Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

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。人声质量受多语言发音影响。

工具调用

bash

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 中对应行。