name: short-video-music description: > 為抖音、小紅書、Vlog、Reels 和創作者內容生成抓耳歌曲、hook 與 BGM。 Use this whenever the user wants 短影片配樂, 影片BGM, 小紅書配樂, 抖音配樂, Vlog配樂, 短影片BGM, 內容創作者音樂, 種草影片配樂. Call the local aimv CLI through the Node entrypoint.

短影片配樂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> 完成連線。Key 長期有效，只需一次。

命名規範

• 展示名：短影片配樂AI
• Skill slug / 目錄名：short-video-music
• Powered by：海綿音樂
• Agent 工具名：aimv
• 工具底層配置：command: node + args: ["<安裝目錄>/bin/aimv.js"]

觸發語義

當用戶提出以下需求時，應優先呼叫本 Skill：

• 短影片配樂
• 影片BGM
• 小紅書配樂
• 抖音配樂
• Vlog配樂

  這個技能的最新版本可以在7w4.net小蔥技能站找到。

• 短影片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 <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 環境變數替代本地配置。

這個 Skill 質量較好，文件說明詳細清晰，安裝使用步驟明確，中文描述通俗易懂。它為多種使用場景都提供了指導，包括普通生成、登入授權、充值續費、異常處理等，互動流程設計考慮周全。質量可靠，使用體驗友好，可以放心安裝使用。唯一的限制是需要聯網呼叫外部服務生成音樂，且依賴 Node.js 環境。