Gerador de Videoclipe Musical com IA
Crie videoclipes musicais completos: música com IA + visuais com IA + montagem com ffmpeg.
Início Rápido
"Faça uma música coreana estilo boy band dos anos 90" → apenas música
"Faça um videoclipe de balada" → música + slideshow MV
"Faça um videoclipe EDM com vídeo completo" → música + clipes de vídeo MV
"Faça um videoclipe Suno" → videoclipe nativo Suno
Fluxo de Trabalho
1. Planeje cenas a partir da letra/mood
Antes de gerar, crie prompts.json — um array de descrições de cenas derivadas da letra, mood e narrativa da música. 8 a 12 cenas para uma música de 3 minutos.
[
{"prompt": "Rua iluminada por neon à noite, reflexos de chuva", "type": "image"},
{"prompt": "Câmera deslizando lentamente sobre um telhado ao pôr do sol", "type": "video"},
"Uma figura solitária caminhando entre cerejeiras em flor"
]
2. Gere a música
bash scripts/suno_music.sh \
--prompt "Letra ou descrição" \
--style "pop anos 90 boy band, coreano" \
--title "Só Você" \
--model V4_5ALL --custom \
--outdir /tmp/mv_project
Opções:
--model V4_5ALL(padrão),V5,V4_5PLUS,V4_5,V4--instrumental— sem vocais--vocal-gender m|f— dica de gênero vocal--negative-tags "Heavy Metal, Bateria"— estilos a evitar--music-video— gera videoclipe nativo Suno (MP4)--dry-run— apenas verificar custo
Persona (manter estilo consistente):
--persona-id ID— usar persona existente (mesmo vocal/estilo para várias músicas)--create-persona— criar persona a partir da música gerada → salva empersona.json--persona-name "Nome"/--persona-desc "Descrição"/--persona-style "Estilo"
Funcionalidades automáticas:
- 🎤 Letras Temporizadas: Faixas não instrumentais buscam automaticamente timestamps da letra e salvam como
{outdir}/lyrics.srt - 🎬 Videoclipe Nativo Suno: Com
--music-video, o Suno gera um vídeo MP4 visualizado diretamente - 🎭 Persona: Com
--create-persona, extrai identidade de voz/estilo para reutilização
3. Gere visuais (fluxo MV personalizado)
bash scripts/gen_visuals.sh \
--mode slideshow \
--prompts-file /tmp/mv_project/prompts.json \
--image-provider seedream \
--outdir /tmp/mv_project
Ou com OpenAI (mais barato, resolução mais baixa):
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
Adicione --dry-run primeiro para ver a estimativa de custo antes de gastar.
4. Monte
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
Comportamento das legendas:
- Detecta automaticamente
{outdir}/lyrics.srte sobrepõe as letras automaticamente --subtitle /caminho/para/personalizado.srt— usar arquivo SRT personalizado--no-subtitle— desabilitar completamente a sobreposição de letras
Modos
| Modo | Visual | Melhor Para | Custo (10 cenas) |
|---|---|---|---|
slideshow | Imagens IA | Rápido, barato | ~$0.02 (mini low) / ~$0.09 (mini med) / ~$0.45 (Seedream) |
video | Clipes de vídeo IA | Premium | ~$1.40 (Seedance Lite) / ~$8.00 (Sora 2) |
hybrid | Mistura de ambos | Equilibrado | ~$0.50-$4.00 |
suno-native | MV Suno | Mais fácil | Apenas créditos Suno |
O custo da imagem é baseado em token — a cobrança real pode ser menor que as estimativas listadas. Use --dry-run para custo preciso.
Opções de Provedor
Imagens: --image-provider seedream (recomendado), openai ou google-together
Modelo de Imagem (OpenAI): --image-model gpt-image-1-mini (padrão, barato) ou gpt-image-1 (premium)
Vídeos: --video-provider sora (padrão), sora-pro, seedance-lite, seedance-pro, veo-fast, veo-audio
Qualidade: --image-quality low|medium|high
Rastreamento de Custos
Cada script gera o custo antes e depois. Sempre use --dry-run primeiro.
Os dados de custo são salvos em {outdir}/cost_estimate.json e {outdir}/visuals_meta.json.
Variáveis de Ambiente
export SUNO_API_KEY="sua-chave-sunoapi" # Obrigatório — sunoapi.org
export OPENAI_API_KEY="sua-chave-openai" # Obrigatório — imagens + vídeo Sora
export BYTEPLUS_API_KEY="sua-chave-byteplus" # Opcional — Seedream 4.5 (recomendado para imagens)
export TOGETHER_API_KEY="sua-chave-together" # Opcional — Seedance, Veo, Imagen
export SUNO_CALLBACK_URL="" # Opcional — veja URL de Callback abaixo
⚠️ Chaves obrigatórias: SUNO_API_KEY e OPENAI_API_KEY devem estar definidas antes de executar qualquer script.
BYTEPLUS_API_KEY é necessária para o provedor de imagem Seedream (cadastre-se em console.byteplus.com, 200 imagens gratuitas).
TOGETHER_API_KEY só é necessária para provedores Seedance/Veo/Imagen.
URL de Callback
A API Suno requer um campo callBackUrl para requisições de geração de música.
Por padrão, se SUNO_CALLBACK_URL não estiver definida, o script usa https://localhost/noop
como um endpoint inócuo (uma URL localhost inalcançável que efetivamente desativa callbacks).
Para personalizar: defina SUNO_CALLBACK_URL para seu próprio endpoint, ou defina como
qualquer URL fictícia que você controla. O payload do callback contém metadados da tarefa e
URLs de áudio — nenhuma chave de API é enviada.
Para desabilitar: defina SUNO_CALLBACK_URL=https://localhost/noop ou qualquer URL inalcançável.
A geração ainda funciona via polling; o callback não é necessário para o funcionamento do script.
Fluxo de Persona (Manter Conceito do Canal)
Para criar várias músicas com estilo consistente, como um canal do YouTube:
# 1. Criar primeira música + persona
bash scripts/suno_music.sh \
--prompt "Música para ouvir enquanto revisa código" \
--style "indie rock, energético, vibe de programação" \
--title "Pull Request" \
--custom --create-persona \
--persona-name "Cantor de Trilha Sonora de Programador" \
--persona-desc "Vocal energético e agradável para programadores ouvirem enquanto codam. Transitando entre indie rock, eletrônico e pop." \
--persona-style "indie rock, eletrônico, música de trabalho para desenvolvedores" \
--outdir /tmp/dev-bgm-01
# 2. Verificar personaId em persona.json
cat /tmp/dev-bgm-01/persona.json
# 3. Criar próxima música com a mesma persona — consistência vocal/estilo mantida
bash scripts/suno_music.sh \
--prompt "Música para ouvir durante hora extra" \
--style "pop eletrônico, programação noturna" \
--title "Deploy da Meia-Noite" \
--custom --persona-id <PERSONA_ID> \
--outdir /tmp/dev-bgm-02
A persona lembra as características vocais + estilo musical, mantendo a unidade de todo o canal.
Pré-requisitos
curl,python3,ffmpeg(para montagem)
Referências
- Detalhes da SunoAPI: Leia
references/sunoapi.md - Detalhes dos provedores visuais: Leia
references/visual-providers.md