短视频配乐AI

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

Powered by 海绵音乐。账号、积分、会员和作品库与海绵音乐小程序 / 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 长期有效，只需一次。

命名规范

• 展示名：短视频配乐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 ...。

推荐命令

node <安装目录>/bin/aimv.js song create --brief "为旅行短视频生成一首抓耳的 30 秒歌曲" --wait
node <安装目录>/bin/aimv.js bgm create --brief "精致、有节奏感的美妆短视频 BGM" --wait

错误处理与用户引导

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 完成连接并重试。
• 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 正常。按两级处理：

1. 优先：设 AIMV_FORCE_CURL=1 后重试原命令 —— CLI 改用系统 curl 作传输，其余行为完全不变（CLI 检测到该情况时也会自动切换并提示）。
2. 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 环境变量替代本地配置。