- name
SKILL.md
स्किल फ़ाइल पब्लिशर की रिपॉज़िटरी में ही रहती है।
कॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill ai-music -a cursor -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill ai-music -a claude-code -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill ai-music -a codex -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill ai-music -a grok -yकॉपी किया गया संदेश Grok Bot चैट में भेजें। Bot यह SKILL.md GitHub से लाता है और उसे उन स्किल में जोड़ देता है जो आपके सभी Bot साझा करते हैं।
Install this skill: https://github.com/ZJU-REAL/Easel/tree/HEAD/skills/builtin/ai-musicपब्लिशर से
给短视频、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.mdओवरव्यू
AI 音乐 / BGM 生成:给短视频、社媒内容生成原创背景音乐 / 配乐 / 纯音乐。通过可插拔 provider(阿里 DashScope / Suno 类第三方 API)文生音乐,异步提交→轮询→下载,产物可再裁剪/归一化或加到视频。当用户说“AI 音乐”“AI 配乐”“生成 BGM”“背景音乐”“原创音乐”“AI 作曲”“纯音乐”“给视频配乐”“做首曲子”时使用。与 tts-voiceover 的区别:tts-voiceover 生成人声口播/旁白,ai-music 生成背景音乐/配乐(无人声或带演唱)。
FAQ
पब्लिशर से skills/builtin/ai-music/SKILL.md डाउनलोड करें, या पाथ कॉपी करके रिपॉज़िटरी खोलें। PlugMCP स्किल को सूचीबद्ध करता है, फ़ाइल होस्ट नहीं करता।
पब्लिशर इसे https://github.com/ZJU-REAL/Easel पर रखता है।
Claude, Cursor, Codex और Grok Build वह SKILL.md पढ़ सकते हैं जिसे आप पब्लिशर की रिपॉज़िटरी से जोड़ते हैं। जब आप चैट में स्किल के GitHub फ़ोल्डर का लिंक भेजते हैं, तो Grok Bot उसे इंस्टॉल कर देता है।