AI 音樂影片生成器
建立完整的音樂影片:AI 音樂 + AI 視覺 + ffmpeg 組裝。
快速開始
"90년대 보이밴드 풍 한국어 노래 만들어줘" → 僅音樂
"발라드 뮤비 만들어줘" → 音樂 + 幻燈片 MV
"EDM 뮤비 풀영상으로" → 音樂 + 影片剪輯 MV
"Suno 뮤비로 만들어줘" → Suno 原生音樂影片
工作流程
1. 根據歌詞/氛圍規劃場景
在生成之前,先建立 prompts.json — 根據歌曲的歌詞、氛圍和敘事衍生出的場景描述陣列。一首 3 分鐘的歌曲約需 8-12 個場景。
[
{"prompt": "Neon-lit city street at night, rain reflections", "type": "image"},
{"prompt": "Camera slowly panning across a rooftop at sunset", "type": "video"},
"A lone figure walking through cherry blossoms"
]
2. 生成音樂
bash scripts/suno_music.sh \
--prompt "가사 또는 설명" \
--style "90s boy band pop, korean" \
--title "너만을 원해" \
--model V4_5ALL --custom \
--outdir /tmp/mv_project
選項:
--model V4_5ALL(預設)、V5、V4_5PLUS、V4_5、V4--instrumental— 無歌聲--vocal-gender m|f— 歌聲性別提示--negative-tags "Heavy Metal, Drums"— 要避免的風格--music-video— 生成 Suno 原生音樂影片(MP4)--dry-run— 僅成本檢查
角色(일관된 스타일 유지):
--persona-id ID— 使用現有角色(用相同歌聲/風格生成多首歌曲)--create-persona— 從生成的歌曲建立角色 → 儲存為persona.json--persona-name "이름"/--persona-desc "설명"/--persona-style "스타일"
自動功能:
- 🎤 附時間戳的歌詞:非純音樂曲目會自動擷取歌詞時間戳,並儲存為
{outdir}/lyrics.srt - 🎬 Suno 原生 MV:使用
--music-video參數,Suno 會直接生成可視化的 MP4 影片 - 🎭 角色:使用
--create-persona參數,可提取聲音/風格特徵以供重複使用
3. 生成視覺素材(自訂 MV 流程)
bash scripts/gen_visuals.sh \
--mode slideshow \
--prompts-file /tmp/mv_project/prompts.json \
--image-provider seedream \
--outdir /tmp/mv_project
或使用 OpenAI(較便宜,解析度較低):
bash scripts/gen_visuals.sh \
--mode slideshow \
--prompts-file /tmp/mv_project/prompts.json \
--image-provider openai --image-model gpt-image-1-mini --image-quality medium \
--outdir /tmp/mv_project
在花費前,請先加上 --dry-run 來查看成本估算。
4. 組裝
bash scripts/assemble_mv.sh \
--audio /tmp/mv_project/track_0_xxx.mp3 \
--outdir /tmp/mv_project \
--output /tmp/mv_project/final_mv.mp4 \
--transition fade
字幕行為:
- 自動偵測
{outdir}/lyrics.srt並自動疊加歌詞 --subtitle /path/to/custom.srt— 使用自訂 SRT 檔案--no-subtitle— 完全停用歌詞疊加
模式
| 模式 | 視覺素材 | 最佳用途 | 成本(10 個場景) |
|---|---|---|---|
slideshow | AI 圖像 | 快速、便宜 | ~$0.02 (mini low) / ~$0.09 (mini med) / ~$0.45 (Seedream) |
video | AI 影片剪輯 | 高品質 | ~$1.40 (Seedance Lite) / ~$8.00 (Sora 2) |
hybrid | 兩者混合 | 平衡 | ~$0.50-$4.00 |
suno-native | Suno MV | 最簡單 | 僅需 Suno 點數 |
圖像成本基於 Token — 實際帳單金額可能低於所列估算。請使用 --dry-run 獲取精確成本。
提供者選項
圖像: --image-provider seedream(建議)、openai 或 google-together
圖像模型 (OpenAI): --image-model gpt-image-1-mini(預設,便宜)或 gpt-image-1(高品質)
影片: --video-provider sora(預設)、sora-pro、seedance-lite、seedance-pro、veo-fast、veo-audio
品質: --image-quality low|medium|high
成本追蹤
每個腳本皆會在執行前後輸出成本。務必先使用 --dry-run。
成本資料會儲存至 {outdir}/cost_estimate.json 和 {outdir}/visuals_meta.json。
環境變數
export SUNO_API_KEY="your-sunoapi-key" # 必要 — sunoapi.org
export OPENAI_API_KEY="your-openai-key" # 必要 — 圖像 + Sora 影片
export BYTEPLUS_API_KEY="your-byteplus-key" # 選用 — Seedream 4.5(建議用於圖像)
export TOGETHER_API_KEY="your-together-key" # 選用 — Seedance, Veo, Imagen
export SUNO_CALLBACK_URL="" # 選用 — 請參閱下方的 Callback URL
⚠️ 必要金鑰: 在執行任何腳本前,必須設定 SUNO_API_KEY 和 OPENAI_API_KEY。
若使用 Seedream 圖像提供者,則需要 BYTEPLUS_API_KEY(請在 console.byteplus.com 註冊,可獲得 200 張免費圖像)。
僅在使用 Seedance/Veo/Imagen 提供者時才需要 TOGETHER_API_KEY。
回調 URL
Suno API 在音樂生成請求中需要一個 callBackUrl 欄位。
預設情況下,若未設定 SUNO_CALLBACK_URL,腳本會使用 https://localhost/noop
作為一個無害的空操作端點(一個無法連線的 localhost URL,可有效停用回調)。
若要自訂: 將 SUNO_CALLBACK_URL 設為您自己的端點,或設為
您控制的任何虛擬 URL。回調負載包含任務中繼資料和
音訊 URL — 不會傳送 API 金鑰。
若要停用: 設定 SUNO_CALLBACK_URL=https://localhost/noop 或任何無法連線的 URL。
生成功能仍可透過輪詢正常運作;回調並非腳本運作的必要條件。
角色工作流程(채널 컨셉 유지)
如同 YouTube 頻道,當需要以一致的風格創作多首歌曲時:
# 1. 生成第一首歌 + 建立角色
bash scripts/suno_music.sh \
--prompt "코드 리뷰하며 듣는 노래" \
--style "indie rock, energetic, coding vibe" \
--title "Pull Request" \
--custom --create-persona \
--persona-name "개발자 노동요 싱어" \
--persona-desc "개발자가 코딩하며 듣기 좋은 에너지 넘치는 보컬. 인디록, 일렉, 팝 장르를 넘나든다." \
--persona-style "indie rock, electronic, developer work music" \
--outdir /tmp/dev-bgm-01
# 2. 從 persona.json 確認 personaId
cat /tmp/dev-bgm-01/persona.json
# 3. 用同一個角色生成下一首歌 — 保持歌聲/風格一致
bash scripts/suno_music.sh \
--prompt "야근하면서 듣는 노래" \
--style "electronic pop, night coding" \
--title "Midnight Deploy" \
--custom --persona-id <PERSONA_ID> \
--outdir /tmp/dev-bgm-02
角色能記住聲樂特徵與音樂風格,有助於維持整個頻道的一致性。
先決條件
curl、python3、ffmpeg(用於組裝)
參考資料
- SunoAPI 詳細資訊: 閱讀
references/sunoapi.md - 視覺提供者詳細資訊: 閱讀
references/visual-providers.md