KI-Musikvideo-Generator
Erstellen Sie komplette Musikvideos: KI-Musik + KI-Visuals + ffmpeg-Montage.
Schnellstart
"90년대 보이밴드 풍 한국어 노래 만들어줘" → nur Musik
"발라드 뮤비 만들어줘" → Musik + Slideshow-MV
"EDM 뮤비 풀영상으로" → Musik + Videoclips-MV
"Suno 뮤비로 만들어줘" → Suno-natives Musikvideo
Arbeitsablauf
1. Szenen aus Text/Stimmung planen
Vor der Generierung erstellen Sie prompts.json – ein Array von Szenenbeschreibungen, die aus den Songtexten, der Stimmung und der Erzählung des Songs abgeleitet werden. 8-12 Szenen für einen 3-minütigen Song.
[
{"prompt": "Neonbeleuchtete Stadtstraße bei Nacht, Regenspiegelungen", "type": "image"},
{"prompt": "Kamera schwenkt langsam über ein Dach bei Sonnenuntergang", "type": "video"},
"Eine einsame Gestalt, die durch Kirschblüten geht"
]
2. Musik generieren
bash scripts/suno_music.sh \
--prompt "가사 또는 설명" \
--style "90s boy band pop, korean" \
--title "너만을 원해" \
--model V4_5ALL --custom \
--outdir /tmp/mv_project
Optionen:
--model V4_5ALL(Standard),V5,V4_5PLUS,V4_5,V4--instrumental— kein Gesang--vocal-gender m|f— Hinweis auf das Vokalgeschlecht--negative-tags "Heavy Metal, Drums"— zu vermeidende Stile--music-video— Suno-natives Musikvideo (MP4) generieren--dry-run— nur Kostenprüfung
Persona (konsistenten Stil beibehalten):
--persona-id ID— vorhandene Persona verwenden (mehrere Songs mit derselben Stimme/demselben Stil generieren)--create-persona— Persona aus generiertem Song erstellen → inpersona.jsonspeichern--persona-name "Name"/--persona-desc "Beschreibung"/--persona-style "Stil"
Auto-Funktionen:
- 🎤 Zeitgestempelte Liedtexte: Nicht-instrumentale Tracks holen automatisch Liedtext-Zeitstempel und speichern sie als
{outdir}/lyrics.srt - 🎬 Suno-natives MV: Mit
--music-videogeneriert Suno direkt ein visualisiertes MP4-Video - 🎭 Persona: Mit
--create-personawird eine Identität aus Stimme/Stil extrahiert und kann wiederverwendet werden
3. Visuelle Inhalte generieren (benutzerdefinierter MV-Ablauf)
bash scripts/gen_visuals.sh \
--mode slideshow \
--prompts-file /tmp/mv_project/prompts.json \
--image-provider seedream \
--outdir /tmp/mv_project
Oder mit OpenAI (günstiger, niedrigere Auflösung):
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
Fügen Sie zuerst --dry-run hinzu, um eine Kostenschätzung zu erhalten, bevor Ausgaben anfallen.
4. Zusammensetzen
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
Untertitel-Verhalten:
- Erkennt automatisch
{outdir}/lyrics.srtund blendet Texte automatisch ein --subtitle /pfad/zu/benutzerdefiniert.srt— benutzerdefinierte SRT-Datei verwenden--no-subtitle— Texteinblendung vollständig deaktivieren
Modi
| Modus | Visuell | Am besten für | Kosten (10 Szenen) |
|---|---|---|---|
slideshow | KI-Bilder | Schnell, günstig | ~$0.02 (mini low) / ~$0.09 (mini med) / ~$0.45 (Seedream) |
video | KI-Videoclips | Premium | ~$1.40 (Seedance Lite) / ~$8.00 (Sora 2) |
hybrid | Mischung aus beidem | Ausgewogen | ~$0.50-$4.00 |
suno-native | Suno-MV | Am einfachsten | Nur Suno-Guthaben |
Die Bildkosten sind tokenbasiert – die tatsächliche Abrechnung kann niedriger sein als die angegebenen Schätzungen. Verwenden Sie --dry-run für genaue Kosten.
Anbieter-Optionen
Bilder: --image-provider seedream (empfohlen), openai oder google-together
Bildmodell (OpenAI): --image-model gpt-image-1-mini (Standard, günstig) oder gpt-image-1 (Premium)
Videos: --video-provider sora (Standard), sora-pro, seedance-lite, seedance-pro, veo-fast, veo-audio
Qualität: --image-quality low|medium|high
Kostenverfolgung
Jedes Skript gibt die Kosten vor und nach der Ausführung aus. Verwenden Sie immer zuerst --dry-run.
Kostendaten werden in {outdir}/cost_estimate.json und {outdir}/visuals_meta.json gespeichert.
Umgebungsvariablen
export SUNO_API_KEY="Ihr-Sunoapi-Schlüssel" # Erforderlich – sunoapi.org
export OPENAI_API_KEY="Ihr-OpenAI-Schlüssel" # Erforderlich – Bilder + Sora-Video
export BYTEPLUS_API_KEY="Ihr-Byteplus-Schlüssel" # Optional – Seedream 4.5 (für Bilder empfohlen)
export TOGETHER_API_KEY="Ihr-Together-Schlüssel" # Optional – Seedance, Veo, Imagen
export SUNO_CALLBACK_URL="" # Optional – siehe Callback-URL unten
⚠️ Erforderliche Schlüssel: SUNO_API_KEY und OPENAI_API_KEY müssen vor dem Ausführen eines Skripts gesetzt sein.
BYTEPLUS_API_KEY wird für den Seedream-Bild-Anbieter benötigt (Anmeldung unter console.byteplus.com, 200 kostenlose Bilder).
TOGETHER_API_KEY wird nur für Seedance/Veo/Imagen-Anbieter benötigt.
Callback-URL
Die Suno-API erfordert ein callBackUrl-Feld für Musikgenerierungsanfragen.
Standardmäßig, wenn SUNO_CALLBACK_URL nicht gesetzt ist, verwendet das Skript https://localhost/noop
als harmlosen Noop-Endpunkt (eine unerreichbare localhost-URL, die Callbacks effektiv deaktiviert).
Zur Anpassung: Setzen Sie SUNO_CALLBACK_URL auf Ihren eigenen Endpunkt oder auf eine beliebige Dummy-URL, die Sie kontrollieren. Die Callback-Nutzlast enthält Aufgabenmetadaten und Audio-URLs – es werden keine API-Schlüssel gesendet.
Zum Deaktivieren: Setzen Sie SUNO_CALLBACK_URL=https://localhost/noop oder eine beliebige unerreichbare URL. Die Generierung funktioniert weiterhin über Polling; der Callback ist für die Skriptfunktion nicht erforderlich.
Persona-Workflow (Kanalkonzept beibehalten)
Für die Erstellung mehrerer Songs mit einem einheitlichen Stil, wie bei einem YouTube-Kanal:
# 1. Ersten Song generieren + Persona erstellen
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. personaId in persona.json überprüfen
cat /tmp/dev-bgm-01/persona.json
# 3. Nächsten Song mit derselben Persona generieren – Stimme/Stil konsistent halten
bash scripts/suno_music.sh \
--prompt "야근하면서 듣는 노래" \
--style "electronic pop, night coding" \
--title "Midnight Deploy" \
--custom --persona-id <PERSONA_ID> \
--outdir /tmp/dev-bgm-02
Die Persona merkt sich die Vocal-Eigenschaften und den Musikstil und sorgt so für Einheitlichkeit im gesamten Kanal.
Voraussetzungen
curl,python3,ffmpeg(für die Montage)
Referenzen
- SunoAPI-Details: Lesen Sie
references/sunoapi.md - Visual-Anbieter-Details: Lesen Sie
references/visual-providers.md