mcpField
A
audio-music-generate

audio-music-generate

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

About audio-music-generate

This Skill generates instrumental music and BGM through Meitu OpenAPI, for users who need atmospheric background tracks. An Agent turns a style or scene description into a prompt and saves the result as an MP3, with durations from 30 to 120 seconds.

Key features

  1. 01Generate instrumental music and BGM
  2. 02Styles include jazz, classical, and electronic
  3. 03Set duration from 30 to 120 seconds
  4. 04Save MP3 files to an output directory

Use cases

  1. 01Create background music for videos or presentations
  2. 02Generate atmospheric instrumental tracks

Install

Copy the command and run it in a terminal.

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

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

Details

From the project README

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
  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-music-generate/；mkdir -p
Execute

触发信号 / 路由规则

核心维度：纯音乐场景命中 + 参数齐全。

场景判定关键词路由
纯音乐 / BGM / 背景音乐明确要求生成 BGM、纯音乐、无人声背景音乐audio_peanut_generate

单 API 工具：参数齐全即调用，失败重试 1 次后返回错误；不做跨工具兜底。

参数定义

参数类型必填范围默认说明
promptSTRING是----纯音乐描述（主题/风格/场景/情绪）。缺失 → 提示"请描述你想要的音乐风格或场景"
durationNUMBER是30–12030生成时长（秒）。超出范围自动钳位至 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 中对应行。

Comments

Markdown supported