短视频配乐AI

短视频配乐AI适合抖音、小红书、Vlog、Reels、产品种草和品牌社媒内容，用于生成短视频配乐、抓耳歌曲、hook、背景音乐和纯音乐 BGM。描述视频主题、情绪和节奏后，AI 助手会生成可试听、可下载的音乐结果；作品会同步到海绵音乐账号，可在「海绵音乐AI写歌」小程序和 lexuan.club 网页继续管理。

本地 CLI 入口

推荐 Agent 工具名：aimv。
发布包入口：bin/aimv.js。直接 shell 执行时使用 node <安装目录>/bin/aimv.js ...。
这是通用本地 Node CLI，不是 MCP server；不要把 bin/aimv.js 当成 MCP stdio 服务注册。
第一次生成前如果未登录，Agent 应直接运行 node <安装目录>/bin/aimv.js init：CLI 会输出连接页链接 https://lexuan.club/skills/connect?slug=short-video-music&from=skill，把链接发给用户；用户网页登录（新用户自动注册）后复制 API Key 贴回对话，Agent 再运行 node <安装目录>/bin/aimv.js init --api-key <KEY> 完成连接。Key 长期有效，只需一次。

命名规范

展示名：短视频配乐AI
Skill slug / 目录名：short-video-music
Powered by：海绵音乐
Agent 工具名：aimv
工具底层配置：command: node + args: ["<安装目录>/bin/aimv.js"]

触发语义

当用户提出以下需求时，应优先调用本 Skill：

短视频配乐
视频BGM
小红书配乐
抖音配乐
Vlog配乐
短视频BGM
内容创作者音乐
种草视频配乐
short video music
TikTok music
reels music
vlog BGM

适用场景

为短视频生成抓耳 hook
为 Vlog、小红书和 Reels 生成 BGM
为产品种草和社媒活动制作配乐
把创作者 brief 变成歌曲或背景音乐候选

典型用户说法

给美妆短视频生成一段精致、有节奏感的 BGM
为旅行短视频生成一首抓耳的 30 秒歌曲
给产品开箱视频做一段轻快背景音乐

Agent 调用原则

如果当前 Agent 能执行 shell，初始化、生成、查询、下载都应由 Agent 直接运行 CLI。
不要要求用户手动打开网页或复制命令，除非当前 Agent 没有命令执行权限。
若已注册 aimv 工具，可直接调用 aimv song create / aimv bgm create 等逻辑命令。
若未注册工具，直接运行 node <安装目录>/bin/aimv.js ...。

错误处理与用户引导

CLI 会输出 [error] / [hint] 结构化标签。Agent 应按标签处理，而不是只复述报错。

code=auth_required：[error] 标签携带 connect_url=（即 https://lexuan.club/skills/connect?slug=short-video-music&from=skill），把链接发给用户；用户登录复制 API Key 后，运行 node <安装目录>/bin/aimv.js init --api-key <KEY> 完成连接并重试。
code=insufficient_points：后台业务码 402。[error] 标签携带 pay_url=，把充值链接发给用户（网页登录即可充值，桌面可扫码支付），完成后重试刚才的命令。
code=quota_limited：后台业务码 429 或额度/次数上限。同样把 pay_url= 链接发给用户开通会员提升额度，完成后重试。
code=wait_timeout：等待超时但任务仍在后台生成（不是失败），稍后按 hint 查询状态。
code=reference_not_ready：先查询参考素材或项目状态，稍后再重试生成。
code=not_found：ID 可能错误、已删除或不属于当前账号；优先用 aimv session tail 找最近项目和歌曲。

登录与充值都在海绵音乐网页完成：连接用 connect_url、充值用 pay_url，把链接作为可点击文本发给用户即可。

受限环境：直接调 API（curl）

部分 Agent 沙箱只放行 curl 等白名单工具，限制其他进程联网。症状：aimv 命令报网络错误或 HTTP 400，而 curl 正常。按两级处理：

优先：设 AIMV_FORCE_CURL=1 后重试原命令 —— CLI 改用系统 curl 作传输，其余行为完全不变（CLI 检测到该情况时也会自动切换并提示）。
CLI 完全不可用时：直接用 curl 调 API，三步闭环：

# API Key 来自连接页 https://lexuan.club/skills/connect?slug=short-video-music&from=skill

# 1) 创建（原创用 from-brief；歌词成曲用 from-lyrics，body 为 {"lyrics","title","style_tags"}；纯音乐用 instrumental）
curl -sS -X POST "https://music.68zysm.cn/api/v3/ai-music/generations/from-brief" \
  -H "X-API-Key: $AIMV_API_KEY" -H "X-Platform: skill" \
  -H "X-App-Id: short-video-music" -H "X-AIMV-Skill-Slug: short-video-music" \
  -H "Content-Type: application/json" -d '{"brief":"轻快的夏日流行歌"}'
# → {"code":0,"data":{"project_id":"...","status":"pending"}}

# 2) 轮询直到 data.status=completed（建议每 3 秒一次）
curl -sS "https://music.68zysm.cn/api/v3/ai-music/projects/<project_id>" \
  -H "X-API-Key: $AIMV_API_KEY" -H "X-Platform: skill" \
  -H "X-App-Id: short-video-music" -H "X-AIMV-Skill-Slug: short-video-music"
# → data.songs[] 为两首候选，各有 song_id 与 audio_url

# 3) 下载（audio_url 为公开 CDN 地址，无需鉴权头）
curl -L -o song1.mp3 "<audio_url>"

约定与 CLI 一致：响应信封 {"code":0,"message":"...","data":...}；code=402 → 把 data.pay_url 充值链接发给用户，完成后重试；code=429 同理；每个项目固定两首候选歌，必须都呈现。参考音频上传：curl -F "file=@./demo.mp3" https://music.68zysm.cn/api/v3/ai-music/reference-audios/upload（带同样的鉴权头）。HOME 缺失的沙箱可用 AIMV_CONFIG_DIR 重定向 CLI 配置目录、AIMV_API_KEY 环境变量替代本地配置。

短视频配乐AI

短视频配乐AI

本地 CLI 入口

命名规范

触发语义

适用场景

典型用户说法

Agent 调用原则

推荐命令

错误处理与用户引导

受限环境：直接调 API（curl）