Générateur de clips musicaux IA
Créez des clips musicaux complets : musique IA + visuels IA + assemblage ffmpeg.
Démarrage rapide
"90년대 보이밴드 풍 한국어 노래 만들어줘" → musique uniquement
"발라드 뮤비 만들어줘" → musique + diaporama MV
"EDM 뮤비 풀영상으로" → musique + séquences vidéo MV
"Suno 뮤비로 만들어줘" → clip vidéo natif Suno
Flux de travail
1. Planifier les scènes à partir des paroles/ambiance
Avant de générer, créez prompts.json — un tableau de descriptions de scènes dérivées des paroles, de l'ambiance et de la narration de la chanson. 8 à 12 scènes pour une chanson de 3 minutes.
[
{"prompt": "Rue de ville illuminée au néon la nuit, reflets de pluie", "type": "image"},
{"prompt": "Caméra panoramique lente sur un toit au coucher du soleil", "type": "video"},
"Une silhouette solitaire marchant à travers des cerisiers en fleurs"
]
2. Générer la musique
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(par défaut),V5,V4_5PLUS,V4_5,V4--instrumental— pas de voix--vocal-gender m|f— indication du genre vocal--negative-tags "Heavy Metal, Drums"— styles à éviter--music-video— générer un clip vidéo natif Suno (MP4)--dry-run— vérification du coût uniquement
Persona (maintien d'un style cohérent) :
--persona-id ID— utiliser un persona existant (générer plusieurs chansons avec la même voix/style)--create-persona— créer un persona à partir de la chanson générée → sauvegarde danspersona.json--persona-name "Nom"/--persona-desc "Description"/--persona-style "Style"
Fonctionnalités automatiques :
- 🎤 Paroles synchronisées : Les pistes non instrumentales récupèrent automatiquement les timings des paroles et les sauvegardent dans
{outdir}/lyrics.srt - 🎬 Clip natif Suno : Avec
--music-video, Suno génère directement une vidéo MP4 visualisée - 🎭 Persona : Avec
--create-persona, extrait l'identité vocale/style pour une réutilisation
3. Générer les visuels (flux personnalisé)
bash scripts/gen_visuals.sh \
--mode slideshow \
--prompts-file /tmp/mv_project/prompts.json \
--image-provider seedream \
--outdir /tmp/mv_project
Ou avec OpenAI (moins cher, résolution inférieure) :
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
Ajoutez --dry-run d'abord pour afficher l'estimation du coût avant de dépenser.
4. Assembler
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
Comportement des sous-titres :
- Détecte automatiquement
{outdir}/lyrics.srtet superpose les paroles automatiquement --subtitle /path/to/custom.srt— utiliser un fichier SRT personnalisé--no-subtitle— désactiver complètement la superposition des paroles
Modes
| Mode | Visuel | Idéal pour | Coût (10 scènes) |
|---|---|---|---|
slideshow | Images IA | Rapide, économique | ~0,02 $ (mini low) / ~0,09 $ (mini med) / ~0,45 $ (Seedream) |
video | Séquences vidéo IA | Premium | ~1,40 $ (Seedance Lite) / ~8,00 $ (Sora 2) |
hybrid | Mélange des deux | Équilibré | ~0,50 $ - 4,00 $ |
suno-native | Clip Suno | Le plus simple | Crédits Suno uniquement |
Le coût des images est basé sur les jetons — la facturation réelle peut être inférieure aux estimations fournies. Utilisez --dry-run pour un coût précis.
Options des fournisseurs
Images : --image-provider seedream (recommandé), openai ou google-together
Modèle d'image (OpenAI) : --image-model gpt-image-1-mini (par défaut, économique) ou gpt-image-1 (premium)
Vidéos : --video-provider sora (par défaut), sora-pro, seedance-lite, seedance-pro, veo-fast, veo-audio
Qualité : --image-quality low|medium|high
Suivi des coûts
Chaque script affiche le coût avant et après. Faites toujours --dry-run d'abord.
Les données de coût sont sauvegardées dans {outdir}/cost_estimate.json et {outdir}/visuals_meta.json.
Variables d'environnement
export SUNO_API_KEY="votre-clé-sunoapi" # Requis — sunoapi.org
export OPENAI_API_KEY="votre-clé-openai" # Requis — images + vidéo Sora
export BYTEPLUS_API_KEY="votre-clé-byteplus" # Optionnel — Seedream 4.5 (recommandé pour les images)
export TOGETHER_API_KEY="votre-clé-together" # Optionnel — Seedance, Veo, Imagen
export SUNO_CALLBACK_URL="" # Optionnel — voir URL de rappel ci-dessous
⚠️ Clés requises : SUNO_API_KEY et OPENAI_API_KEY doivent être définies avant d'exécuter un script.
BYTEPLUS_API_KEY est nécessaire pour le fournisseur d'images Seedream (inscrivez-vous sur console.byteplus.com, 200 images gratuites).
TOGETHER_API_KEY n'est nécessaire que pour les fournisseurs Seedance/Veo/Imagen.
URL de rappel
L'API Suno nécessite un champ callBackUrl pour les demandes de génération musicale.
Par défaut, si SUNO_CALLBACK_URL n'est pas défini, le script utilise https://localhost/noop
comme un point de terminaison inoffensif (une URL localhost inaccessible qui désactive effectivement les rappels).
Pour personnaliser : définissez SUNO_CALLBACK_URL sur votre propre point de terminaison, ou définissez-le sur
n'importe quelle URL factice que vous contrôlez. La charge utile du rappel contient des métadonnées de tâche et
des URL audio — aucune clé API n'est envoyée.
Pour désactiver : définissez SUNO_CALLBACK_URL=https://localhost/noop ou toute URL inaccessible.
La génération fonctionne toujours par sondage ; le rappel n'est pas nécessaire au fonctionnement du script.
Flux de travail Persona (maintien du concept de chaîne)
Pour créer plusieurs chansons avec un style cohérent, comme une chaîne YouTube :
# 1. Créer la première chanson + créer un persona
bash scripts/suno_music.sh \
--prompt "Chanson à écouter en faisant une revue de code" \
--style "indie rock, energetic, coding vibe" \
--title "Pull Request" \
--custom --create-persona \
--persona-name "Chanteur BGM développeur" \
--persona-desc "Voix énergique, idéale pour un développeur qui code. Mélange indé rock, électro, pop." \
--persona-style "indie rock, electronic, developer work music" \
--outdir /tmp/dev-bgm-01
# 2. Vérifier le personaId dans persona.json
cat /tmp/dev-bgm-01/persona.json
# 3. Générer la chanson suivante avec le même persona — cohérence vocale/style
bash scripts/suno_music.sh \
--prompt "Chanson à écouter en faisant des heures sup'" \
--style "electronic pop, night coding" \
--title "Midnight Deploy" \
--custom --persona-id <PERSONA_ID> \
--outdir /tmp/dev-bgm-02
Le persona mémorise les caractéristiques vocales + le style musical, ce qui maintient une cohérence sur l'ensemble de la chaîne.
Prérequis
curl,python3,ffmpeg(pour l'assemblage)
Références
- Détails SunoAPI : Lire
references/sunoapi.md - Détails des fournisseurs visuels : Lire
references/visual-providers.md