mcpField
A
audio-music-generate

audio-music-generate

github.com/meituクリエイティブ・メディア36117 回インストール9 週間前に更新
リポジトリ

audio-music-generate について

Meitu OpenAPI を使い、ボーカルなしの音楽を生成する Skill です。雰囲気作りや背景音楽が必要な場面向けで、スタイルやシーンの説明をプロンプトに整え、30～120秒の MP3 を保存します。

主な機能

  1. 01ボーカルなしの音楽と BGM の生成
  2. 02ジャズ、クラシック、電子音楽などに対応
  3. 0330～120秒の長さ指定
  4. 04指定ディレクトリへの MP3 保存

活用シーン

  1. 01動画やプレゼン用の背景音楽制作
  2. 02雰囲気を添えるインスト曲の生成

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/audio-music-generateを入力して読み込まれたか確認します。

詳細

プロジェクトの 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 中对应行。

コメント

Markdown 対応