Música
Crie músicas e instrumentais com o Suno e outros modelos e depois estenda, faça covers e mashups, edite, separe e converta tudo com o MCP do Nodaro.
As ferramentas de música permitem que um assistente crie e edite músicas no Nodaro. generate_music cria uma faixa a partir de um prompt, ou segue uma faixa de referência com o MiniMax Music. As ferramentas suno_ usam todos os recursos do Suno: músicas com a sua própria letra, covers, extensões, mashups, substituição de seções, stems, arquivos WAV e videoclipes, e suno_speech cria fala expressiva. Todas as ferramentas precisam da permissão workflows:execute e retornam um ID de tarefa.
| Ferramenta | O que faz | Créditos |
|---|---|---|
generate_music | Uma faixa a partir de um prompt | 33 com o Suno, 198 com o MiniMax |
suno_generate | Uma música com todos os controles do Suno | 33 |
suno_lyrics | A letra de uma música a partir de um tema | 11 |
suno_style_boost | Tags de estilo mais ricas a partir de uma descrição curta | 11 |
suno_extend | Continua uma música do Suno | 33 |
suno_upload_extend | Continua uma faixa enviada | 33 |
suno_cover | A mesma música num novo estilo | 33 |
suno_mashup | Mistura duas faixas | 33 |
suno_replace_section | Gera de novo uma parte de uma música do Suno | 22 |
suno_add_vocals | Adiciona vocais a um instrumental do Suno | 33 |
suno_add_instrumental | Adiciona uma camada instrumental a uma música do Suno | 33 |
suno_separate_stems | Separa qualquer áudio em vocais e instrumental, em stems ou em um instrumento | 44, 143 para todos os stems em uma só execução, ou 88 para um instrumento |
suno_convert_wav | Converte uma música do Suno, ou um stem de uma separação do Suno, para WAV | 11 |
suno_music_video | Cria um videoclipe a partir de uma música do Suno | 11 |
suno_speech | Fala a partir de um resumo de uma linha ou do seu roteiro, duas tomadas por execução | Um preço fixo por execução |
As ferramentas que editam uma música do Suno precisam do ID de tarefa do Nodaro de uma música feita com o Suno, passado como audio_asset_id. Os IDs do Suno de que elas precisam são buscados no servidor. Uma tomada de suno_speech é fala, não uma música: suno_extend, suno_separate_stems e suno_convert_wav a recusam pelos IDs, sem cobrança.
generate_music
Cria uma faixa musical a partir de um prompt. Com um modelo do Suno, o padrão, funciona como o nó Gerar música com Suno. Com minimax, executa o MiniMax Music como o nó Gerar música e precisa de uma faixa de referência.
Permissão: workflows:execute. Créditos: 33 com um modelo do Suno, 198 com o MiniMax.
| Parâmetro | Tipo | Observações |
|---|---|---|
prompt | string | A música que você quer, com até 2.000 caracteres. Obrigatório, a menos que uma predefinição o forneça. |
model | string | suno-v6 (padrão, riqueza de detalhes e vocais naturais), suno-v6_wild (mais ousado, menos previsível), suno-v6_mini (mais rápido), suno-v5_5, suno-v5, suno-v4_5plus, suno-v4_5all, suno-v4_5, suno ou minimax (MiniMax Music), que segue uma faixa de referência. suno-v5-5 também é aceito no lugar de suno-v5_5. |
reference_audio_url | string | Com minimax: a URL pública da música, da voz ou do instrumental que o MiniMax Music segue. |
reference_audio_asset_id | string | Com minimax: o ID de tarefa do Nodaro de um resultado de áudio a seguir. É usado quando reference_audio_url não está definido. |
lyrics | string | As palavras exatas a cantar, com até 2.000 caracteres, com tags de seção como [Verse] e [Chorus] em linhas próprias. A letra muda o Suno para o modo personalizado, em que ela é cantada como foi escrita. Sem letra, o modelo escreve a própria. |
title | string | O título da música, com até 80 caracteres. O modo personalizado precisa de um; sem ele, o título fica “Untitled”. |
instrumental | boolean | Música sem vocais. |
genre, mood | string | O gênero e o clima. |
duration | number | A duração de uma faixa curta, até 30 segundos. Sem ela, o modelo escolhe a duração. Para definir uma duração de até 360 segundos, use suno_generate. Com o Suno, duration só funciona no modo personalizado num modelo V6, e uma duração abaixo de 10 segundos sobe para 10. Numa faixa instrumental, um title ou uma duration ativa o modo personalizado sozinho. O MiniMax Music ignora esse parâmetro. |
presetId | string | Uma predefinição como Lo-fi para estudar, Trailer cinematográfico ou Drop de EDM. |
Com minimax, passe reference_audio_url ou reference_audio_asset_id. Sem uma referência, a ferramenta retorna um erro que pede uma, e nenhuma tarefa é iniciada. Os modelos do Suno não precisam de referência e ignoram os dois parâmetros.
Retorna: um ID de tarefa.
suno_generate
Cria uma música original com o Suno, com todos os controles do Suno. Funciona como o nó Gerar música com Suno. A saída da tarefa contém os IDs do Suno que as outras ferramentas suno_ usam.
Permissão: workflows:execute. Créditos: 33.
| Parâmetro | Tipo | Observações |
|---|---|---|
prompt | string | Obrigatório. A música, ou a inspiração para ela, com até 5.000 caracteres. No modo personalizado, descreve o estilo. |
model | string | V6 (padrão), V6_WILD, V6_MINI, V5_5, V5, V4_5PLUS, V4_5ALL, V4_5 ou V4. |
custom_mode | boolean | Usa os seus lyrics e style exatamente como foram escritos. |
lyrics | string | A letra completa, com até 5.000 caracteres. Só no modo personalizado. |
style | string | Tags de estilo, como lo-fi hip-hop, melancholy, piano, com até 500 caracteres. |
negative_style | string | Estilos a evitar, com até 500 caracteres. |
title | string | Até 80 caracteres. |
instrumental | boolean | Música sem vocais. |
vocal_gender | string | male ou female. |
duration | number | A duração da música, de 10 a 360 segundos. Só no modo personalizado num modelo V6. |
style_weight, weirdness, audio_weight | number | De 0 a 1: a força com que o estilo é aplicado, o quanto o resultado é incomum e o peso da entrada de áudio. |
Retorna: um ID de tarefa.
suno_lyrics
Escreve a letra de uma música a partir de um tema, como “uma balada de coração partido sobre o verão”. Use o resultado como lyrics em suno_generate, com o modo personalizado.
Permissão: workflows:execute. Créditos: 11.
| Parâmetro | Tipo | Observações |
|---|---|---|
prompt | string | Obrigatório. O tema, com até 1.000 caracteres. |
Retorna: um ID de tarefa. A letra fica na saída da tarefa, e o cartão a mostra com um botão Copy.
suno_style_boost
Transforma uma descrição curta de estilo, como “lo-fi tranquilo”, em tags de estilo mais ricas. Use o resultado como style em suno_generate.
Permissão: workflows:execute. Créditos: 11.
| Parâmetro | Tipo | Observações |
|---|---|---|
content | string | Obrigatório. O estilo a aprimorar, com até 5.000 caracteres. |
Retorna: um ID de tarefa. O estilo aprimorado fica na saída da tarefa.
suno_extend
Continua uma música feita com o Suno.
Permissão: workflows:execute. Créditos: 33.
| Parâmetro | Tipo | Observações |
|---|---|---|
audio_asset_id | string | Obrigatório. O ID de tarefa do Nodaro da música do Suno. |
continue_at | number | O segundo da música em que a extensão começa. |
prompt, style, title | string | Orientam a extensão. |
vocal_gender | string | male ou female. |
model | string | V6 (padrão) ou outra versão do Suno. |
Retorna: um ID de tarefa.
suno_upload_extend
Continua uma faixa que não foi feita com o Suno, a partir de uma URL pública. Para uma música do Suno, use suno_extend.
Permissão: workflows:execute. Créditos: 33.
| Parâmetro | Tipo | Observações |
|---|---|---|
audio_url | string | Obrigatório. A URL pública da faixa. |
continue_at | number | Obrigatório. O segundo em que o Suno continua. |
style, negative_style, title, vocal_gender, model | Como em suno_generate. | |
use_default_params | boolean | true deixa o Suno escolher o estilo e o título. O padrão, false, usa o seu style e o seu title. |
Retorna: um ID de tarefa.
suno_cover
Faz um cover de uma faixa: a mesma melodia e a mesma letra num novo estilo musical. A origem pode ser qualquer áudio do Nodaro, não só uma música do Suno.
Permissão: workflows:execute. Créditos: 33.
| Parâmetro | Tipo | Observações |
|---|---|---|
prompt | string | Obrigatório. O estilo do cover, com até 5.000 caracteres. |
audio_url ou audio_asset_id | string | A faixa de origem. |
task_id, audio_id | string | Uma música sua do Suno criada no Nodaro, indicada pelo ID da tarefa e pelo ID da faixa do Suno, os dois juntos. Sem audio_url nem audio_asset_id, o Suno faz o cover da música pelos IDs, sem novo envio, pelo mesmo preço. Quando um áudio também é passado, o cover usa o áudio e os IDs não são usados. Até 200 caracteres cada. |
instrumental | boolean | Um cover instrumental, sem vocais. |
lyrics | string | Uma nova letra. Sem ela, o Suno reutiliza a letra que ouve na origem. |
custom_mode, style, title, vocal_gender, model | Como em suno_generate. |
Um cover por ID só funciona quando as configurações servem para ele: no modo simples, o prompt é enviado como o estilo, e no modo personalizado, o prompt é cantado como a letra. Uma requisição que não serve é recusada antes da execução, sem cobrança, e pede o áudio. Veja Cover de uma música do Suno pelos IDs.
Retorna: um ID de tarefa. Só faça covers de áudios que pertencem a você; a receita song-from-reference explica como criar uma música parecida a partir da faixa de outra pessoa. Veja Receitas de conteúdo.
suno_mashup
Mistura duas faixas num mashup.
Permissão: workflows:execute. Créditos: 33.
| Parâmetro | Tipo | Observações |
|---|---|---|
audio_url_1 ou audio_asset_id_1 | string | A primeira faixa. |
audio_url_2 ou audio_asset_id_2 | string | A segunda faixa. |
custom_mode, style, negative_style, title, vocal_gender | Como em suno_generate. |
Retorna: um ID de tarefa.
suno_replace_section
Gera de novo uma parte de uma música do Suno e mantém o resto.
Permissão: workflows:execute. Créditos: 22.
| Parâmetro | Tipo | Observações |
|---|---|---|
audio_asset_id | string | Obrigatório. O ID de tarefa do Nodaro da música do Suno. |
infill_start_s, infill_end_s | number | Obrigatório. A parte a substituir, em segundos. Ela precisa durar de 6 a 60 segundos e no máximo metade da música. |
prompt | string | Obrigatório. O que a nova parte deve conter, com até 5.000 caracteres. |
tags | string | Obrigatório. Tags de estilo para a nova parte, com até 500 caracteres. |
negative_tags | string | Estilos a manter fora da nova parte. |
full_lyrics | string | A letra da música inteira depois da alteração, com as partes alteradas e as não alteradas. |
title | string | Até 80 caracteres. |
Retorna: um ID de tarefa.
suno_add_vocals
Adiciona vocais a um instrumental do Suno.
Permissão: workflows:execute. Créditos: 33.
| Parâmetro | Tipo | Observações |
|---|---|---|
audio_asset_id | string | Obrigatório. O ID de tarefa do Nodaro do instrumental do Suno. |
model | string | V6 (padrão), V6_WILD, V6_MINI, V4_5PLUS, V5 ou V5_5. |
Retorna: um ID de tarefa.
suno_add_instrumental
Adiciona uma camada instrumental a uma música do Suno.
Permissão: workflows:execute. Créditos: 33.
| Parâmetro | Tipo | Observações |
|---|---|---|
audio_asset_id | string | Obrigatório. O ID de tarefa do Nodaro da música do Suno. |
model | string | V6 (padrão), V6_WILD, V6_MINI, V4_5PLUS, V5 ou V5_5. |
Retorna: um ID de tarefa.
suno_separate_stems
Separa qualquer áudio com o Suno em vocais e instrumental, em um stem para cada instrumento, ou em um instrumento indicado e a música sem ele. O áudio pode ser uma música do Suno, um envio ou qualquer áudio gerado. O Suno recusa gravações lançadas comercialmente e áudios com mais de 20 MB. Para esses, defina fallback_to_demucs ou use separate_audio. Funciona como o nó Separar com Suno.
Permissão: workflows:execute. Créditos: 44 com separate_vocal, 143 com split_stem, 88 com split_stem_advanced. Uma execução que passa para o Demucs é cobrada pelo preço da Separação de áudio.
| Parâmetro | Tipo | Observações |
|---|---|---|
audio_url ou audio_asset_id | string | Exatamente um dos dois. audio_url é qualquer áudio por link. audio_asset_id é uma tarefa de áudio do Nodaro ou um arquivo de áudio enviado. Uma música do Suno é separada pelos IDs do Suno dela. |
type | string | separate_vocal (padrão) para vocais e instrumental, split_stem para cada instrumento, ou split_stem_advanced para um instrumento. |
stem_name | string | Só com split_stem_advanced. Um dos nomes de instrumento do Suno, como Piano ou Lead Vocal (padrão). |
fallback_to_demucs | boolean | Quando o Suno recusa, usa o Demucs e cobra o preço dele. Só para vocais e stems completos. Padrão: false. |
Retorna: um ID de tarefa. Com split_stem_advanced, isolatedUrl e withoutUrl da tarefa trazem o primeiro take, e isolated2Url e without2Url, o segundo.
suno_convert_wav
Converte uma música do Suno, ou um stem de uma tarefa de suno_separate_stems, num arquivo WAV sem perdas. Funciona como o nó Converter para WAV com Suno.
Permissão: workflows:execute. Créditos: 11.
| Parâmetro | Tipo | Observações |
|---|---|---|
audio_asset_id | string | Obrigatório. O ID de tarefa do Nodaro da música do Suno ou de uma separação do Suno. |
stem | string | Só com uma separação: o stem a converter. Uma das saídas vocals, instrumental, isolated e without, ou um campo de resultado da separação, como drumsUrl, bassUrl ou isolatedUrl. Qualquer outro valor é um erro. |
Uma separação feita pelo Demucs, ou uma que não guardou os IDs dos stems, é recusada antes da execução, sem cobrança. Veja Converter um stem de Separar com Suno.
Retorna: um ID de tarefa.
suno_music_video
Cria um videoclipe em MP4 a partir de uma música do Suno. As imagens vêm do áudio, e não há estilo nem prompt a definir. Funciona como o nó Videoclipe.
Permissão: workflows:execute. Créditos: 11.
| Parâmetro | Tipo | Observações |
|---|---|---|
audio_asset_id | string | Obrigatório. O ID de tarefa do Nodaro de uma música do Suno. Músicas de outros modelos, como MiniMax ou ElevenLabs, não podem ser usadas. |
Retorna: um ID de tarefa.
suno_speech
Cria fala com o Fala com Suno: tom, ritmo e emoção, com música de fundo opcional. Não é uma conversão de texto em fala com uma voz fixa, e cada execução gera duas tomadas. Funciona como o nó Fala com Suno.
Permissão: workflows:execute. Créditos: um preço fixo por execução, pelas duas tomadas, qualquer que seja o modo. GET /v1/credits/model-cost?model=suno-speech responde o preço.
| Parâmetro | Tipo | Observações |
|---|---|---|
mode | string | brief (padrão): o Suno escreve o roteiro a partir de prompt e o interpreta. script: o Suno fala script. |
prompt | string | Modo resumo: uma descrição da cena em uma linha, com até 3.000 caracteres. |
script | string | Modo roteiro: o texto a ser falado, com até 5.000 caracteres. As quebras de linha são mantidas. |
tone | string | Modo roteiro: tom, ritmo, emoção e ambiente, como um sotaque ou o estilo da música, com até 1.000 caracteres. |
variety | integer | Modo roteiro: quanto as duas tomadas diferem, de 0 (estilo exato) a 4 (variação extrema). Sem ele, o modelo decide. |
vocal_gender | string | Modo roteiro: female ou male. Sem ele, o modelo escolhe. |
background_music | boolean | Modo roteiro: adiciona música de fundo. |
Os limites contam os caracteres depois que os espaços do início e do fim são removidos. Um texto vazio, ou acima do limite, é recusado antes da execução, sem cobrança. Um campo do outro modo é ignorado.
Retorna: um ID de tarefa. O audioUrl da tarefa concluída é a primeira tomada, audioUrls tem as duas tomadas, e sunoTracks traz o ID, o título e a duração de cada tomada.
Perguntas frequentes
Qual é a diferença entre generate_music e suno_generate?
generate_music é a ferramenta simples para criar uma faixa a partir de um prompt, com o Suno V6 por padrão. O modelo minimax dela, o MiniMax Music, segue uma faixa de referência que você passa como reference_audio_url ou reference_audio_asset_id. suno_generate expõe os controles do próprio Suno, como o modo personalizado com a sua letra e o seu estilo, a estranheza, o peso do estilo e os estilos negativos.
Quanto custa uma música do Suno?
33 créditos por geração, em todas as versões do Suno. Letras, reforço de estilo, conversão para WAV e videoclipes custam 11 créditos, e substituir uma seção custa 22.
Posso separar qualquer música em stems?
Sim. suno_separate_stems aceita qualquer áudio, uma música do Suno, um envio ou um link, de até 20 MB. O Suno recusa gravações lançadas comercialmente. Para elas, use separate_audio, que usa o Demucs, ou defina fallback_to_demucs.
Como faço uma música com a minha própria letra?
Chame suno_generate com custom_mode definido como true, a sua letra com tags de seção como [Verse] e [Chorus] e um estilo. Com generate_music, passar lyrics ativa o mesmo modo personalizado.
Um assistente pode criar uma narração com o Suno?
Sim. suno_speech cria fala com o Fala com Suno. Com mode brief, o Suno escreve e interpreta um roteiro a partir de uma cena de uma linha. Com mode script, ele fala o seu texto, com tom, variação, gênero da voz e música de fundo opcionais. Cada execução retorna duas tomadas.
Páginas relacionadas
Gerar música com Suno
Gerar música
Áudio
Suno V6
Receitas de conteúdo
Última atualização
Áudio
Gere fala e diálogos, crie e troque vozes, duble, crie efeitos sonoros, transcreva e limpe ou corte áudio com as ferramentas de áudio do MCP do Nodaro.
Personagens
Crie personagens num assistente de IA, gere e aprove os retratos, adicione expressões, poses, ângulos e clipes de movimento e reutilize-os como referência.