AI 音乐视频生成器
创建完整的音乐视频:AI 音乐 + AI 视觉 + ffmpeg 组装。
快速开始
"90년대 보이밴드 풍 한국어 노래 만들어줘" → 仅音乐
"발라드 뮤비 만들어줘" → 音乐 + 幻灯片 MV
"EDM 뮤비 풀영상으로" → 音乐 + 视频剪辑 MV
"Suno 뮤비로 만들어줘" → Suno 原生音乐视频
工作流程
1. 根据歌词/情绪规划场景
在生成之前,创建 prompts.json — 一个场景描述数组,这些描述源自歌曲的歌词、情绪和叙事。对于一首 3 分钟的歌曲,通常需要 8-12 个场景。
[
{"prompt": "霓虹灯闪烁的城市街道,夜晚,雨水倒影", "type": "image"},
{"prompt": "摄像机在日落时分缓慢扫过屋顶", "type": "video"},
"一个人影独自走过樱花"
]
2. 生成音乐
bash scripts/suno_music.sh \
--prompt "가사 또는 설명" \
--style "90年代男孩乐队流行风,韩语" \
--title "너만을 원해" \
--model V4_5ALL --custom \
--outdir /tmp/mv_project
选项:
--model V4_5ALL(默认),V5,V4_5PLUS,V4_5,V4--instrumental— 无 vocals--vocal-gender m|f— vocals 性别提示--negative-tags "重金属音乐, 鼓点"— 要避免的风格--music-video— 生成 Suno 原生音乐视频(MP4)--dry-run— 仅成本检查
角色(일관된 스타일 유지):
--persona-id ID— 使用现有角色(以相同的 vocals/风格生成多首歌曲)--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="" # 可选 — 参见下面的回调 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. 使用相同的角色生成下一首歌曲 — 保持 vocals/风格一致性
bash scripts/suno_music.sh \
--prompt "야근하면서 듣는 노래" \
--style "electronic pop, night coding" \
--title "Midnight Deploy" \
--custom --persona-id <PERSONA_ID> \
--outdir /tmp/dev-bgm-02
角色会记住 vocals 特性 + 音乐风格,从而保持整个频道的一致感。
前提条件
curl、python3、ffmpeg(用于组装)
参考资料
- SunoAPI 详情: 阅读
references/sunoapi.md - 视觉提供商详情: 阅读
references/visual-providers.md