- name
SKILL.md
File skill tetap berada di repositori penerbit.
Tempel perintah yang disalin di terminal. Perintah itu memasang SKILL.md ini ke agen tersebut.
npx skills add ZJU-REAL/Easel --skill ai-music -a cursor -yTempel perintah yang disalin di terminal. Perintah itu memasang SKILL.md ini ke agen tersebut.
npx skills add ZJU-REAL/Easel --skill ai-music -a claude-code -yTempel perintah yang disalin di terminal. Perintah itu memasang SKILL.md ini ke agen tersebut.
npx skills add ZJU-REAL/Easel --skill ai-music -a codex -yTempel perintah yang disalin di terminal. Perintah itu memasang SKILL.md ini ke agen tersebut.
npx skills add ZJU-REAL/Easel --skill ai-music -a grok -yKirim pesan yang disalin di chat Grok Bot. Bot mengambil SKILL.md ini dari GitHub dan menambahkannya ke skill yang dipakai bersama oleh semua Bot Anda.
Install this skill: https://github.com/ZJU-REAL/Easel/tree/HEAD/skills/builtin/ai-musicDari penerbit
给短视频、Vlog、社媒内容生成原创背景音乐 / 配乐 / 纯音乐。全程通过共享脚本
skills/shared/scripts/ai_music.py 封装音乐生成 API(可插拔 provider),
异步提交 → 轮询 → 下载。生成的音乐可再交给 audio_ops.py / video_ops.py
做裁剪、归一化或加到视频。
边界:本 SKILL 只做背景音乐 / 配乐。要人声口播 / 旁白 / 朗读用 tts-voiceover。
outputs/主题名/)配置检查路径铁律:先
cd到运行时说明给出的 Easel 项目根,确认当前目录有.env和skills/shared/scripts/,再运行注册表、check或生成命令。不得改用 workspace 的共享脚本副本,也不得以env/printenv没显示变量为由判断未配置。
在项目根 .env 或环境变量中设置(脚本自动向上查找 .env)。用户自己填 key。
通用
MUSIC_PROVIDER=dashscope # 或 suno-compatible;也可用 --provider 覆盖
provider = dashscope(阿里云 DashScope / 百炼)
DASHSCOPE_API_KEY=... # 必填(别名 DASHSCOPE_KEY / ALIYUN_API_KEY)
DASHSCOPE_MUSIC_MODEL=audio-generation # 可选(兼容旧名 DASHSCOPE_MODEL)
DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/api/v1 # 可选
provider = suno-compatible(Suno 类第三方 API 网关)
MUSIC_API_KEY=... # 必填
MUSIC_BASE_URL=https://api.example.com/v1 # 必填,你的 API 根地址
MUSIC_MODEL=music-1 # 可选,按服务商模型名调整
先跑 python skills/shared/scripts/model_registry.py configured --group music --env-file .env。只有一个可用时直接显式传 --provider;多个可用且用户没点名时,先列出选项询问,不按 MUSIC_PROVIDER 擅自选择。
脚本路径(相对项目根):skills/shared/scripts/ai_music.py。每个子命令支持 -h。
python skills/shared/scripts/ai_music.py check --provider dashscope
缺 key 会明确列出缺哪个 env(含别名提示)。配置齐了再往下。
# 纯音乐 BGM(dashscope)
python skills/shared/scripts/ai_music.py generate --provider dashscope \
--prompt "轻快的 lo-fi 嘻哈,钢琴 + 柔和鼓点,适合 vlog 片头" \
--duration 30 --instrumental \
-o outputs/主题名/vlog-bgm.mp3
# 带演唱(suno-compatible,给了歌词)
python skills/shared/scripts/ai_music.py generate --provider suno-compatible \
--prompt "温暖的民谣,吉他弹唱" \
--lyrics "$(cat lyrics.txt)" \
-o outputs/主题名/song.mp3
--poll-interval(轮询间隔,默认 5s)、--timeout(超时,默认 300s)可按需调。
# ① 裁剪到片头需要的长度
python skills/shared/scripts/audio_ops.py trim outputs/主题名/vlog-bgm.mp3 \
-o outputs/主题名/bgm-8s.mp3 --duration 8
# ② 归一化到社媒响度(-14 LUFS)
python skills/shared/scripts/audio_ops.py normalize outputs/主题名/vlog-bgm.mp3 \
-o outputs/主题名/bgm-norm.mp3
# ③ 把 BGM 加到视频(可调原声/BGM 音量比,自动循环并截断)
python skills/shared/scripts/video_ops.py bgm -i clip.mp4 -o clip_bgm.mp4 \
--music outputs/主题名/vlog-bgm.mp3 --voice-volume 1.0 --music-volume 0.3
outputs/主题名/。audio_ops.py / video_ops.py。--provider + env,SKILL 流程不变。audio_mix.py mix;给视频加 BGM/旁白才用 video_ops.py bgm(旁白短于视频时加 --music-loop-off)。AI 音乐 / BGM 生成:给短视频、社媒内容生成原创背景音乐 / 配乐 / 纯音乐。通过可插拔 provider(阿里 DashScope / Suno 类第三方 API)文生音乐,异步提交→轮询→下载,产物可再裁剪/归一化或加到视频。当用户说“AI 音乐”“AI 配乐”“生成 BGM”“背景音乐”“原创音乐”“AI 作曲”“纯音乐”“给视频配乐”“做首曲子”时使用。与 tts-voiceov
---name: ai-musicdescription: AI 音乐 / BGM 生成:给短视频、社媒内容生成原创背景音乐 / 配乐 / 纯音乐。通过可插拔 provider(阿里 DashScope / Suno 类第三方…---# skills/builtin/ai-music/SKILL.mdRingkasan umum
AI 音乐 / BGM 生成:给短视频、社媒内容生成原创背景音乐 / 配乐 / 纯音乐。通过可插拔 provider(阿里 DashScope / Suno 类第三方 API)文生音乐,异步提交→轮询→下载,产物可再裁剪/归一化或加到视频。当用户说“AI 音乐”“AI 配乐”“生成 BGM”“背景音乐”“原创音乐”“AI 作曲”“纯音乐”“给视频配乐”“做首曲子”时使用。与 tts-voiceover 的区别:tts-voiceover 生成人声口播/旁白,ai-music 生成背景音乐/配乐(无人声或带演唱)。
FAQ
Unduh skills/builtin/ai-music/SKILL.md dari penerbit, atau salin path-nya dan buka repositori. PlugMCP hanya mendaftar skill ini dan tidak meng-host filenya.
Penerbit menyimpannya di https://github.com/ZJU-REAL/Easel.
Claude, Cursor, Codex, dan Grok Build bisa membaca SKILL.md yang Anda tambahkan dari repositori penerbit. Grok Bot memasangnya saat Anda mengirim tautan folder GitHub skill tersebut di chat.