Generador de Videos Musicales con IA
Crea videos musicales completos: música IA + visuales IA + ensamblaje con ffmpeg.
Inicio Rápido
"90년대 보이밴드 풍 한국어 노래 만들어줘" → solo música
"발라드 뮤비 만들어줘" → música + video de presentación
"EDM 뮤비 풀영상으로" → música + videoclips
"Suno 뮤비로 만들어줘" → video musical nativo de Suno
Flujo de Trabajo
1. Planificar escenas a partir de la letra/ambiente
Antes de generar, crea prompts.json — un arreglo de descripciones de escenas derivadas de la letra, el ambiente y la narrativa de la canción. De 8 a 12 escenas para una canción de 3 minutos.
[
{"prompt": "Calle de ciudad iluminada con neón por la noche, reflejos de lluvia", "type": "image"},
{"prompt": "Cámara paneando lentamente sobre un tejado al atardecer", "type": "video"},
"Una figura solitaria caminando entre cerezos en flor"
]
2. Generar música
bash scripts/suno_music.sh \
--prompt "가사 또는 설명" \
--style "pop de banda juvenil de los 90, coreano" \
--title "너만을 원해" \
--model V4_5ALL --custom \
--outdir /tmp/mv_project
Opciones:
--model V4_5ALL(predeterminado),V5,V4_5PLUS,V4_5,V4--instrumental— sin voces--vocal-gender m|f— indicación de género vocal--negative-tags "Heavy Metal, Drums"— estilos a evitar--music-video— generar video musical nativo de Suno (MP4)--dry-run— solo verificar costo
Persona (일관된 스타일 유지):
--persona-id ID— usar una persona existente (generar varias canciones con la misma voz/estilo)--create-persona— crear una persona a partir de la canción generada → guarda enpersona.json--persona-name "이름"/--persona-desc "설명"/--persona-style "스타일"
Características automáticas:
- 🎤 Letras con marcas de tiempo: Las pistas no instrumentales obtienen automáticamente las marcas de tiempo de la letra y se guardan como
{outdir}/lyrics.srt - 🎬 MV Nativo de Suno: Con
--music-video, Suno genera un video MP4 visualizado directamente - 🎭 Persona: Con
--create-persona, extrae la identidad de voz/estilo para reutilizarla
3. Generar visuales (flujo de MV personalizado)
bash scripts/gen_visuals.sh \
--mode slideshow \
--prompts-file /tmp/mv_project/prompts.json \
--image-provider seedream \
--outdir /tmp/mv_project
O con OpenAI (más barato, menor resolución):
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
Agrega --dry-run primero para mostrar la estimación de costo antes de gastar.
4. Ensamblar
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
Comportamiento de subtítulos:
- Detecta automáticamente
{outdir}/lyrics.srty superpone las letras automáticamente --subtitle /path/to/custom.srt— usar un archivo SRT personalizado--no-subtitle— deshabilitar completamente la superposición de letras
Modos
| Modo | Visual | Mejor Para | Costo (10 escenas) |
|---|---|---|---|
slideshow | Imágenes IA | Rápido, barato | ~$0.02 (mini low) / ~$0.09 (mini med) / ~$0.45 (Seedream) |
video | Videoclips IA | Premium | ~$1.40 (Seedance Lite) / ~$8.00 (Sora 2) |
hybrid | Mezcla de ambos | Equilibrado | ~$0.50-$4.00 |
suno-native | MV de Suno | Más fácil | Solo créditos de Suno |
El costo de las imágenes se basa en tokens — la facturación real puede ser menor que las estimaciones listadas. Usa --dry-run para un costo preciso.
Opciones de Proveedor
Imágenes: --image-provider seedream (recomendado), openai o google-together
Modelo de Imagen (OpenAI): --image-model gpt-image-1-mini (predeterminado, barato) o gpt-image-1 (premium)
Videos: --video-provider sora (predeterminado), sora-pro, seedance-lite, seedance-pro, veo-fast, veo-audio
Calidad: --image-quality low|medium|high
Seguimiento de Costos
Cada script genera el costo antes y después. Siempre usa --dry-run primero.
Los datos de costo se guardan en {outdir}/cost_estimate.json y {outdir}/visuals_meta.json.
Variables de Entorno
export SUNO_API_KEY="tu-clave-sunoapi" # Requerida — sunoapi.org
export OPENAI_API_KEY="tu-clave-openai" # Requerida — imágenes + video Sora
export BYTEPLUS_API_KEY="tu-clave-byteplus" # Opcional — Seedream 4.5 (recomendado para imágenes)
export TOGETHER_API_KEY="tu-clave-together" # Opcional — Seedance, Veo, Imagen
export SUNO_CALLBACK_URL="" # Opcional — ver URL de Callback abajo
⚠️ Claves requeridas: SUNO_API_KEY y OPENAI_API_KEY deben estar configuradas antes de ejecutar cualquier script.
Se necesita BYTEPLUS_API_KEY para el proveedor de imágenes Seedream (regístrate en console.byteplus.com, 200 imágenes gratis).
TOGETHER_API_KEY solo es necesario para los proveedores Seedance/Veo/Imagen.
URL de Callback
La API de Suno requiere un campo callBackUrl para las solicitudes de generación de música.
De forma predeterminada, si SUNO_CALLBACK_URL no está configurada, el script usa https://localhost/noop
como un endpoint no operativo inofensivo (una URL de localhost inalcanzable que desactiva efectivamente los callbacks).
Para personalizar: establece SUNO_CALLBACK_URL a tu propio endpoint, o configúralo en
cualquier URL ficticia que controles. El payload del callback contiene metadatos de la tarea y
URLs de audio — no se envían claves API.
Para deshabilitar: establece SUNO_CALLBACK_URL=https://localhost/noop o cualquier URL inalcanzable.
La generación aún funciona mediante sondeo; el callback no es necesario para que el script funcione.
Flujo de Trabajo de Persona (채널 컨셉 유지)
Para crear varias canciones con un estilo consistente, como un canal de YouTube:
# 1. Generar primera canción + crear persona
bash scripts/suno_music.sh \
--prompt "Canción para escuchar mientras se revisa código" \
--style "indie rock, enérgico, ambiente de programación" \
--title "Pull Request" \
--custom --create-persona \
--persona-name "Cantante de música de trabajo para desarrolladores" \
--persona-desc "Vocal enérgica ideal para que los desarrolladores escuchen mientras programan. Abarca indie rock, electrónica y pop." \
--persona-style "indie rock, electrónica, música de trabajo para desarrolladores" \
--outdir /tmp/dev-bgm-01
# 2. Verificar personaId en persona.json
cat /tmp/dev-bgm-01/persona.json
# 3. Generar la siguiente canción con la misma persona — mantener consistencia vocal/estilo
bash scripts/suno_music.sh \
--prompt "Canción para escuchar mientras se trabaja hasta tarde" \
--style "pop electrónico, programación nocturna" \
--title "Midnight Deploy" \
--custom --persona-id <PERSONA_ID> \
--outdir /tmp/dev-bgm-02
La persona recuerda las características vocales + el estilo musical, manteniendo la uniformidad en todo el canal.
Prerrequisitos
curl,python3,ffmpeg(para el ensamblaje)
Referencias
- Detalles de SunoAPI: Lee
references/sunoapi.md - Detalles de proveedores visuales: Lee
references/visual-providers.md