ai-music-video
Generate AI music videos end-to-end. Creates music with Suno (sunoapi.org), generates visuals with OpenAI/Seedream/Google/Seedance, and assembles into music video with ffmpeg. Supports timestamped lyrics (auto SRT), Suno native music video generation, slideshow/video/hybrid modes. Token-based cost tracking per generation.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/gprecious/ai-music-videoAI Music Video Generator
Create complete music videos: AI music + AI visuals + ffmpeg assembly.
Quick Start
"90년대 보이밴드 풍 한국어 노래 만들어줘" → music only
"발라드 뮤비 만들어줘" → music + slideshow MV
"EDM 뮤비 풀영상으로" → music + video clips MV
"Suno 뮤비로 만들어줘" → Suno native music video
Workflow
1. Plan scenes from lyrics/mood
Before generating, create prompts.json — array of scene descriptions derived from the song's lyrics, mood, and narrative. 8-12 scenes for a 3-min song.
[
{"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. Generate music
bash scripts/suno_music.sh \
--prompt "가사 또는 설명" \
--style "90s boy band pop, korean" \
--title "너만을 원해" \
--model V4_5ALL --custom \
--outdir /tmp/mv_project
Options:
--model V4_5ALL(default),V5,V4_5PLUS,V4_5,V4--instrumental— no vocals--vocal-gender m|f— vocal gender hint--negative-tags "Heavy Metal, Drums"— styles to avoid--music-video— generate Suno native music video (MP4)--dry-run— cost check only
Persona (일관된 스타일 유지):
--persona-id ID— 기존 페르소나 사용 (같은 보컬/스타일로 여러 곡 생성)--create-persona— 생성된 곡에서 페르소나 생성 →persona.json저장--persona-name "이름"/--persona-desc "설명"/--persona-style "스타일"
Auto features:
- 🎤 Timestamped Lyrics: Non-instrumental tracks automatically fetch lyrics timestamps and save as
{outdir}/lyrics.srt - 🎬 Suno Native MV: With
--music-video, Suno generates a visualized MP4 video directly - 🎭 Persona: With
--create-persona, extracts voice/style identity for reuse
3. Generate visuals (custom MV flow)
bash scripts/gen_visuals.sh \
--mode slideshow \
--prompts-file /tmp/mv_project/prompts.json \
--image-provider seedream \
--outdir /tmp/mv_project
Or with OpenAI (cheaper, lower res):
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
Add --dry-run first to show cost estimate before spending.
4. Assemble
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
Subtitle behavior:
- Auto-detects
{outdir}/lyrics.srtand overlays lyrics automatically --subtitle /path/to/custom.srt— use custom SRT file--no-subtitle— disable lyrics overlay entirely
Modes
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-gprecious-ai-music-video": {
"enabled": true,
"auto_update": true
}
}
}