1. Comece por aqui
O SunoDock 2.0 une geração de título, prompt de estilo e letra via IA, envio automático para a sua aba logada do Suno (por extensão de navegador) e download direto das músicas em MP3 com capa embutida, WAV ou formato original — tanto para uma faixa quanto em lote ou logo após a criação.
Tenha conexão com a internet e espaço livre para os arquivos. Para a automação de criação no Suno, mantenha a extensão do SunoDock 2.0 instalada no Chrome/Edge e uma aba logada no Suno.
2. Como abrir o site
- Se estiver usando em um domínio público publicado, basta acessar o endereço do seu site no navegador.
- Para uso local na pasta
D:\baixakisuno\versão 2.0, dê dois cliques em INICIAR.bat. - Se a porta 3000 já estiver ocupada pela versão 1, a versão 2.0 sobe automaticamente na porta 3001 (
http://localhost:3001/).
0.0.0.0 com porta configurável via variável PORT, pronta para rodar em servidores web e domínios públicos.Para guardar este manual em PDF, use Ctrl+P e “Salvar como PDF”.
4. Copiar e conferir um link
- Abra a música desejada no Suno.
- Use a opção de compartilhar ou copie o endereço da página da música.
- Copie o link completo, começando por
https://. - Cole o endereço no campo correspondente do SunoDock.
O sistema reconhece os formatos https://suno.com/song/…, compartilhamento https://suno.com/s/… e Hook https://suno.com/hook/…. Links de perfil, playlist ou álbum não são aceitos.
5. Baixar uma música
- Abra a aba Baixar música.
- Cole o link em Link da música e clique em Buscar música.
- Confira título, capa e prévia no player.
- Escolha MP3 (com capa embutida), WAV ou Original e clique em Baixar áudio, ou clique em Baixar capa para salvar a imagem separadamente.
6. Qual formato escolher?
| Formato | Quando usar | O que considerar |
|---|---|---|
| MP3 | Ouvir, compartilhar ou usar em players comuns. | Já inclui a capa embutida dentro do arquivo de música. |
| WAV | Edição profissional de áudio e vídeo. | PCM de 16 bits, arquivos maiores; não recupera qualidade ausente na origem. |
| Original | Arquivo original sem recodificação. | Geralmente M4A/Opus conforme servido pelo Suno. |
7. Baixar várias músicas em lote
7.1 Monte a lista
- Abra a aba Em lote.
- Cole até 20 links diferentes. Ao colar um link, o cursor já pula para a linha de baixo e o nome da música é buscado e exibido na frente do link.
- Clique em Carregar músicas e aguarde a lista ficar pronta.
https://suno.com/s/NfbMKTaqw1qzMVLR — 🎵 O HOMEM QUE ME ENSINOU A DIRIGIR https://suno.com/s/JU23gglJh7n2z8LB — 🎵 O FANTASMA DA BR-040
7.2 Baixe música a música
- Escolha o formato (MP3, WAV ou Original) e opcionalmente marque para baixar a capa separada.
- Clique em Baixar selecionadas e autorize múltiplos downloads no navegador se solicitado.
- Cada faixa é salva individualmente direto na pasta Downloads (ex.:
01 - Nome da Musica.mp3).
8. Entender os estados do lote
| Estado | Significado |
|---|---|
| Aguardando | O link está na fila de consulta. |
| Consultando… | Obtendo título e endereço de áudio. |
| Pronta | Áudio público identificado e disponível para baixar. |
| Repetida · ignorada | Faixa duplicada removida automaticamente. |
| Baixando… / Baixada em Downloads | Conversão e download direto música a música na pasta Downloads. |
| Interrompida / Falha | Pode ser retomada clicando em Tentar falhas novamente. |
9. Interromper ou tentar novamente
Use Parar lote a qualquer momento; as músicas já salvas ficam na pasta Downloads. Depois, clique em Tentar falhas novamente para reconsultar e baixar apenas o que faltou, ou Limpar lista para iniciar outra relação.
10. Encontrar e abrir seus arquivos
Todas as músicas (individuais, em lote ou criadas pelo fluxo automático) vão direto para a pasta Downloads do seu navegador. Pressione Ctrl+J no navegador para abrir rapidamente a lista de downloads recentes.
11. Consultor Musical, streaming e fila no Suno
11.1 Configure a OpenAI apenas no Backend
- Abra a aba ⚙️ Admin, cole sua chave OpenAI (
sk-...) e clique em Salvar Configurações Admin ✓. - A chave fica guardada somente no servidor (banco SQLite ou variável
OPENAI_API_KEY) e nunca é exibida ao navegador. - No mesmo painel você define o modelo (ex.:
gpt-4o-mini,gpt-4o,gpt-4.1), instruções permanentes, limites e acompanha o custo estimado em USD.
11.2 Converse por projeto com memória persistente
- Em Consultor & Suno, escolha ou crie um Projeto Musical e edite sua Memória & Regras (estilo base, preferências como Sertanejo raiz, Sertanejo romântico anos 90, Moda de viola, Vaneirão e música gaúcha).
- Converse normalmente em tempo real (respostas em streaming SSE). Você pode usar comandos curtos como “Crie mais uma”, “Não gostei”, “Mude o refrão”, “Use outra história”, “Faça como a anterior”, “Crie o título do vídeo” e “Descrição com tracklist”.
- Todas as conversas ficam salvas no servidor para continuar mesmo após fechar o navegador.
- Cada música traz Título, Prompt Suno, Exclude Styles, Configurações Musicais e Letra com botões individuais para copiar e envio automático para a fila do Suno.
11.3 Extensão e criação automática no Suno
- Clique em Baixar Extensão (.zip) e carregue em
chrome://extensionsouedge://extensionscom Modo do desenvolvedor ativo. - Deixe uma aba logada em
https://suno.com/create. - Clique em Enviar fila para o Suno. A extensão preenche Título, Style of Music, Exclude Styles e Lyrics, aciona Create, captura os links via Compartilhar / Copy Link e o site baixa as 2 versões em MP3 com capa.
12. Biblioteca por projeto e títulos repetidos
Todas as músicas geradas no chat ou salvas no editor vão para a Biblioteca do projeto no banco SQLite. Se surgir um título igual a outro já salvo no mesmo projeto, o cartão destaca um aviso de Título repetido no projeto. Na aba Biblioteca você filtra por projeto, busca por texto ou exibe apenas duplicadas, com cópia rápida de cada bloco.
13. Privacidade e segurança das chaves
- Sua chave da OpenAI fica exclusivamente no backend (
data/studio.sqliteou variável de ambiente), jamais exposta ao navegador ou retornada em respostas JSON. - Projetos, memórias, histórico de chat, biblioteca e logs de uso permanecem no banco local SQLite do servidor.
- A extensão atua somente entre a aba do SunoDock 2.0 e a página
suno.com; arquivos temporários FFmpeg são apagados após cada entrega.
14. Solução de problemas
| Sintoma | Como resolver |
|---|---|
| A extensão aparece como “não detectada”. | Verifique se carregou a pasta descompactada em chrome://extensions ou edge://extensions e atualize a página do site. |
| A extensão abriu o Suno mas não preencheu. | Verifique se você está logado na sua conta em suno.com/create e tente enviar novamente. |
| O Suno pediu verificação humana. | Resolva o desafio na aba do Suno; não feche a aba do site para ele capturar e baixar as 2 faixas quando concluírem. |
| Erro de chave inválida ou provedor não detectado. | Para DeepSeek e Qwen (chaves sk-...), selecione o provedor manualmente na lista em vez de deixar no modo automático. |
| Baixou apenas a 1ª das 2 músicas. | Autorize múltiplos downloads para o domínio do site quando o navegador solicitar permissão, ou clique no botão manual ao lado da faixa na tela. |
15. O que a Versão 2.0 faz — e limites
| Disponível na 2.0 | Depende do Suno / Terceiros |
|---|---|
| Geração de título, prompt de estilo e letra em 8 provedores de IA (com detecção automática). | Créditos e assinatura de API pertencem a cada usuário. |
| Extensão agnóstica de domínio que injeta no modo Custom do Suno e captura as 2 versões criadas. | Verificações CAPTCHA precisam de ação humana do usuário na aba do Suno. |
| Download automático das 2 faixas em MP3 com capa embutida + download individual e em lote. | Mudanças futuras no layout do Suno podem exigir atualização da extensão. |
16. Exemplos práticos
Fluxo completo automatizado
1) Selecione OpenAI ou Gemini e cole sua API Key.
2) Em tema escreva: “Forró romântico animado sobre encontro no fim de tarde”.
3) Clique em 🚀 Gerar na IA + Criar no Suno + Baixar as 2.
4) O sistema gera título, style e letra, envia ao Suno logado, aguarda as 2 versões finalizarem e salva 01 - ...mp3 e 02 - ...mp3 com capa na sua pasta Downloads.
17. Hospedagem em domínio e manutenção
- A pasta isolada fica em
versão 2.0, preservando intacta a versão 1 na raiz. - Variáveis de ambiente suportadas:
PORT(padrão3000, com fallback local para3001) eHOST(padrão0.0.0.0para acesso em domínio/servidor). - Dependências: Node.js >= 20, pacote npm
fflateeffmpegdisponível no servidor (FFMPEG_PATHopcional). - Para implantar em VPS/Render/Railway/Docker, aponte o diretório da versão 2.0, rode
npm installe inicie comnpm startatrás de HTTPS no seu domínio. - Execute a suíte de testes com
npm test.
18. Checklist rápido
- Chave de API da IA inserida no painel.
- Extensão
sunodock-v2-extensao.zipcarregada no Chrome/Edge. - Conta logada e aberta em
suno.com/create. - Botão de criação/envio acionado e downloads múltiplos autorizados no navegador.
- As 2 músicas salvas em MP3 com capa na pasta Downloads.