# 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. Source: https://nodaro.ai/pt-BR/docs/mcp/tools/music 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. Todas as ferramentas precisam da permissão `workflows:execute` e retornam um ID de job. | Ferramenta | O que faz | Créditos | | --- | --- | --- | | [`generate_music`](#generate_music) | Uma faixa a partir de um prompt | 33 com o Suno, 198 com o MiniMax | | [`suno_generate`](#suno_generate) | Uma música com todos os controles do Suno | 33 | | [`suno_lyrics`](#suno_lyrics) | A letra de uma música a partir de um tema | 11 | | [`suno_style_boost`](#suno_style_boost) | Tags de estilo mais ricas a partir de uma descrição curta | 11 | | [`suno_extend`](#suno_extend) | Continua uma música do Suno | 33 | | [`suno_upload_extend`](#suno_upload_extend) | Continua uma faixa enviada | 33 | | [`suno_cover`](#suno_cover) | A mesma música num novo estilo | 33 | | [`suno_mashup`](#suno_mashup) | Mistura duas faixas | 33 | | [`suno_replace_section`](#suno_replace_section) | Gera de novo uma parte de uma música do Suno | 22 | | [`suno_add_vocals`](#suno_add_vocals) | Adiciona vocais a um instrumental do Suno | 33 | | [`suno_add_instrumental`](#suno_add_instrumental) | Adiciona uma camada instrumental a uma música do Suno | 33 | | [`suno_separate_stems`](#suno_separate_stems) | Separa uma música do Suno em vocais e instrumental, ou em stems | 44, ou 143 para cada instrumento | | [`suno_convert_wav`](#suno_convert_wav) | Converte uma música do Suno para WAV | 11 | | [`suno_music_video`](#suno_music_video) | Cria um videoclipe a partir de uma música do Suno | 11 | As ferramentas que editam uma música do Suno precisam do ID de job 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. ## `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** (Suno Create Music)](https://nodaro.ai/docs/nodes/audio/suno-create-music). Com `minimax`, executa o MiniMax Music como o nó [**Gerar música** (Generate Music)](https://nodaro.ai/docs/nodes/audio/generate-music) 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` 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 job 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`](#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 nenhum job é iniciado. Os modelos do Suno não precisam de referência e ignoram os dois parâmetros. **Retorna:** um ID de job. ## `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](https://nodaro.ai/docs/nodes/audio/suno-create-music). A saída do job 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 job. ## `suno_lyrics` Escreve a letra de uma música a partir de um tema, como “a heartbreak ballad about summer”. 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 job. A letra fica na saída do job, e o cartão a mostra com um botão **Copy**. ## `suno_style_boost` Transforma uma descrição curta de estilo, como “lo-fi chill”, 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 job. O estilo aprimorado fica na saída do job. ## `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 job 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 job. ## `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 job. ## `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. | | `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`. | **Retorna:** um ID de job. 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](https://nodaro.ai/docs/mcp/recipes). ## `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 job. ## `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 job 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 job. ## `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 job 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 job. ## `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 job 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 job. ## `suno_separate_stems` Separa uma música do Suno em vocais e instrumental, ou em um stem para cada instrumento. Só funciona em músicas feitas com o Suno; para outros áudios, use [`separate_audio`](https://nodaro.ai/docs/mcp/tools/audio#separate_audio). **Permissão:** `workflows:execute`. **Créditos:** 44 com `separate_vocal`, 143 com `split_stem`. | Parâmetro | Tipo | Observações | | --- | --- | --- | | `audio_asset_id` | string | **Obrigatório.** O ID de job do Nodaro da música do Suno. | | `type` | string | `separate_vocal` (padrão) para vocais e instrumental, ou `split_stem` para cada instrumento. | **Retorna:** um ID de job. ## `suno_convert_wav` Converte uma música do Suno num arquivo WAV sem perdas. **Permissão:** `workflows:execute`. **Créditos:** 11. | Parâmetro | Tipo | Observações | | --- | --- | --- | | `audio_asset_id` | string | **Obrigatório.** O ID de job do Nodaro da música do Suno. | **Retorna:** um ID de job. ## `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** (Music Video)](https://nodaro.ai/docs/nodes/video/music-video). **Permissão:** `workflows:execute`. **Créditos:** 11. | Parâmetro | Tipo | Observações | | --- | --- | --- | | `audio_asset_id` | string | **Obrigatório.** O ID de job 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 job. ## Frequently asked questions ### 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? suno_separate_stems só funciona numa música feita com o Suno no Nodaro. Para qualquer outro áudio, use separate_audio, que separa vocais e instrumentos com o 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.