mcpField
A
audio-song-generate

audio-song-generate

github.com/meituCreative & media36120 installsUpdated 9w ago
Repository

About audio-song-generate

audio-song-generate is a meitu-cli skill for creating songs from a style description and lyrics, including vocals, or instrumental tracks with strong rhythm and full arrangements. It supports music creation and soundtrack generation.

Key features

  1. 01Generate songs from style descriptions and lyrics
  2. 02Create complete vocal song structures
  3. 03Support multiple music styles
  4. 04Generate strongly rhythmic, fully arranged instrumentals
  5. 05Choose a generation model

Use cases

  1. 01Turn lyrics and a style brief into an audio song
  2. 02Create a vocal track for a brand song
  3. 03Generate strongly rhythmic instrumental music

Install

Copy the command and run it in a terminal.

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

After installing, type/audio-song-generatein Claude Code to confirm it loaded.

Details

From the project README

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（风格）为准。

参数定义

参数类型必填范围默认说明
promptSTRING是----歌曲风格描述。缺失 → 提示"请描述你想要的歌曲风格"
prompt_lyricsSTRING是----歌词内容。缺失 → 提示"请提供歌词内容"（强节奏纯音乐场景可填空字符串或风格化描述）
modelSTRING否auto / mureka-6 / mureka-7.5 / mureka-o1auto生成模型选择，非法值回退 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 中对应行。

Comments

Markdown supported