audio-song-generate

Mode d’emploi

Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
Consultez le document original pour les outils, identifiants et environnements requis.
Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.

npx skills add https://github.com/meitu/meitu-skills --skill audio-song-generate

Avant de commencer

L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.

Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

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