NodaroAccount
Docs do Nodaro
DocumentaçãoReferência de nósModelosTemplatesAgentes de IA (MCP)DesenvolvedoresAuto-hospedagemPesquisaComparações
Referência das ferramentas

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.

FerramentaO que fazCréditos
generate_musicUma faixa a partir de um prompt33 com o Suno, 198 com o MiniMax
suno_generateUma música com todos os controles do Suno33
suno_lyricsA letra de uma música a partir de um tema11
suno_style_boostTags de estilo mais ricas a partir de uma descrição curta11
suno_extendContinua uma música do Suno33
suno_upload_extendContinua uma faixa enviada33
suno_coverA mesma música num novo estilo33
suno_mashupMistura duas faixas33
suno_replace_sectionGera de novo uma parte de uma música do Suno22
suno_add_vocalsAdiciona vocais a um instrumental do Suno33
suno_add_instrumentalAdiciona uma camada instrumental a uma música do Suno33
suno_separate_stemsSepara qualquer áudio em vocais e instrumental, em stems ou em um instrumento44, 143 para todos os stems em uma só execução, ou 88 para um instrumento
suno_convert_wavConverte uma música do Suno, ou um stem de uma separação do Suno, para WAV11
suno_music_videoCria um videoclipe a partir de uma música do Suno11
suno_speechFala a partir de um resumo de uma linha ou do seu roteiro, duas tomadas por execuçãoUm 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âmetroTipoObservações
promptstringA música que você quer, com até 2.000 caracteres. Obrigatório, a menos que uma predefinição o forneça.
modelstringsuno-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_urlstringCom minimax: a URL pública da música, da voz ou do instrumental que o MiniMax Music segue.
reference_audio_asset_idstringCom minimax: o ID de tarefa do Nodaro de um resultado de áudio a seguir. É usado quando reference_audio_url não está definido.
lyricsstringAs 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.
titlestringO título da música, com até 80 caracteres. O modo personalizado precisa de um; sem ele, o título fica “Untitled”.
instrumentalbooleanMúsica sem vocais.
genre, moodstringO gênero e o clima.
durationnumberA 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.
presetIdstringUma 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âmetroTipoObservações
promptstringObrigatório. A música, ou a inspiração para ela, com até 5.000 caracteres. No modo personalizado, descreve o estilo.
modelstringV6 (padrão), V6_WILD, V6_MINI, V5_5, V5, V4_5PLUS, V4_5ALL, V4_5 ou V4.
custom_modebooleanUsa os seus lyrics e style exatamente como foram escritos.
lyricsstringA letra completa, com até 5.000 caracteres. Só no modo personalizado.
stylestringTags de estilo, como lo-fi hip-hop, melancholy, piano, com até 500 caracteres.
negative_stylestringEstilos a evitar, com até 500 caracteres.
titlestringAté 80 caracteres.
instrumentalbooleanMúsica sem vocais.
vocal_genderstringmale ou female.
durationnumberA duração da música, de 10 a 360 segundos. Só no modo personalizado num modelo V6.
style_weight, weirdness, audio_weightnumberDe 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âmetroTipoObservações
promptstringObrigató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âmetroTipoObservações
contentstringObrigató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âmetroTipoObservações
audio_asset_idstringObrigatório. O ID de tarefa do Nodaro da música do Suno.
continue_atnumberO segundo da música em que a extensão começa.
prompt, style, titlestringOrientam a extensão.
vocal_genderstringmale ou female.
modelstringV6 (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âmetroTipoObservações
audio_urlstringObrigatório. A URL pública da faixa.
continue_atnumberObrigatório. O segundo em que o Suno continua.
style, negative_style, title, vocal_gender, modelComo em suno_generate.
use_default_paramsbooleantrue 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âmetroTipoObservações
promptstringObrigatório. O estilo do cover, com até 5.000 caracteres.
audio_url ou audio_asset_idstringA faixa de origem.
task_id, audio_idstringUma 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.
instrumentalbooleanUm cover instrumental, sem vocais.
lyricsstringUma nova letra. Sem ela, o Suno reutiliza a letra que ouve na origem.
custom_mode, style, title, vocal_gender, modelComo 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âmetroTipoObservações
audio_url_1 ou audio_asset_id_1stringA primeira faixa.
audio_url_2 ou audio_asset_id_2stringA segunda faixa.
custom_mode, style, negative_style, title, vocal_genderComo 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âmetroTipoObservações
audio_asset_idstringObrigatório. O ID de tarefa do Nodaro da música do Suno.
infill_start_s, infill_end_snumberObrigatório. A parte a substituir, em segundos. Ela precisa durar de 6 a 60 segundos e no máximo metade da música.
promptstringObrigatório. O que a nova parte deve conter, com até 5.000 caracteres.
tagsstringObrigatório. Tags de estilo para a nova parte, com até 500 caracteres.
negative_tagsstringEstilos a manter fora da nova parte.
full_lyricsstringA letra da música inteira depois da alteração, com as partes alteradas e as não alteradas.
titlestringAté 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âmetroTipoObservações
audio_asset_idstringObrigatório. O ID de tarefa do Nodaro do instrumental do Suno.
modelstringV6 (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âmetroTipoObservações
audio_asset_idstringObrigatório. O ID de tarefa do Nodaro da música do Suno.
modelstringV6 (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âmetroTipoObservações
audio_url ou audio_asset_idstringExatamente 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.
typestringseparate_vocal (padrão) para vocais e instrumental, split_stem para cada instrumento, ou split_stem_advanced para um instrumento.
stem_namestringSó com split_stem_advanced. Um dos nomes de instrumento do Suno, como Piano ou Lead Vocal (padrão).
fallback_to_demucsbooleanQuando 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âmetroTipoObservações
audio_asset_idstringObrigatório. O ID de tarefa do Nodaro da música do Suno ou de uma separação do Suno.
stemstringSó 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âmetroTipoObservações
audio_asset_idstringObrigató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âmetroTipoObservações
modestringbrief (padrão): o Suno escreve o roteiro a partir de prompt e o interpreta. script: o Suno fala script.
promptstringModo resumo: uma descrição da cena em uma linha, com até 3.000 caracteres.
scriptstringModo roteiro: o texto a ser falado, com até 5.000 caracteres. As quebras de linha são mantidas.
tonestringModo roteiro: tom, ritmo, emoção e ambiente, como um sotaque ou o estilo da música, com até 1.000 caracteres.
varietyintegerModo roteiro: quanto as duas tomadas diferem, de 0 (estilo exato) a 4 (variação extrema). Sem ele, o modelo decide.
vocal_genderstringModo roteiro: female ou male. Sem ele, o modelo escolhe.
background_musicbooleanModo 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.

Última atualização

Nesta página