Nodaro Docs
DocumentationNode ReferenceModelsAI Agents (MCP)DevelopersSelf-hostingResearch
Tools reference

Music

Create songs and instrumentals with Suno and other music models, then extend, cover, mash up, edit, split and convert them with Nodaro's MCP music tools.

The music tools let an assistant make and edit music in Nodaro. generate_music creates a track from a prompt, and the suno_ tools use Suno's full feature set: songs with your own lyrics, covers, extensions, mashups, section replacement, stems, WAV files and music videos. Every tool needs the workflows:execute permission and returns a job id.

ToolWhat it doesCredits
generate_musicA track from a prompt30 with Suno, 180 with MiniMax
suno_generateA song with Suno's full controls30
suno_lyricsSong lyrics from a theme10
suno_style_boostRicher style tags from a short description10
suno_extendContinues a Suno song30
suno_upload_extendContinues an uploaded track30
suno_coverThe same song in a new style30
suno_mashupBlends two tracks30
suno_replace_sectionGenerates one part of a Suno song again20
suno_add_vocalsAdds vocals to a Suno instrumental30
suno_add_instrumentalAdds an instrumental layer to a Suno song30
suno_separate_stemsSplits a Suno song into vocals and instrumental, or stems40
suno_convert_wavConverts a Suno song to WAV10
suno_music_videoMakes a music video from a Suno song10

The tools that edit a Suno song need the Nodaro job id of a song made with Suno, passed as audio_asset_id. The Suno ids they need are looked up on the server.

generate_music

Creates a music track from a prompt. It works like the Generate Music node.

Permission: workflows:execute. Credits: 30 with a Suno model, 180 with MiniMax.

ParameterTypeNotes
promptstringThe music you want, up to 2,000 characters. Required unless a preset supplies it.
modelstringsuno-v6 (default, rich detail and natural vocals), suno-v6_wild (bolder, less predictable), suno-v6_mini (faster), suno-v5_5, suno-v5, suno, or minimax for short instrumental loops.
lyricsstringThe exact words to sing, up to 2,000 characters, with section tags such as [Verse] and [Chorus] on their own lines. Lyrics switch Suno to custom mode, where they are sung as written. Without lyrics, the model writes its own.
titlestringThe song title, up to 80 characters. Custom mode needs one; without it, the title is "Untitled".
instrumentalbooleanMusic without vocals.
genre, moodstringThe genre and the mood.
durationnumberUp to 30 seconds. With Suno, it works in custom mode.
presetIdstringA preset such as Lo-fi Study, Cinematic Trailer or EDM Drop.

Returns: a job id.

suno_generate

Creates an original song with Suno, with every Suno control. It works like the Suno Create Music node. The job output holds the Suno ids that the other suno_ tools use.

Permission: workflows:execute. Credits: 30.

ParameterTypeNotes
promptstringRequired. The song, or the inspiration for it, up to 5,000 characters. In custom mode, it describes the style.
modelstringV6 (default), V6_WILD, V6_MINI, V5_5, V5, V4_5PLUS, V4_5ALL, V4_5 or V4.
custom_modebooleanUses your lyrics and style exactly as written.
lyricsstringThe full lyrics, up to 5,000 characters. Custom mode only.
stylestringStyle tags, such as lo-fi hip-hop, melancholy, piano, up to 500 characters.
negative_stylestringStyles to avoid, up to 500 characters.
titlestringUp to 80 characters.
instrumentalbooleanMusic without vocals.
vocal_genderstringmale or female.
durationnumberThe song length, from 10 to 360 seconds. Only in custom mode on a V6 model.
style_weight, weirdness, audio_weightnumberFrom 0 to 1: how strongly the style applies, how unusual the result is, and the weight of the audio input.

Returns: a job id.

suno_lyrics

Writes song lyrics from a theme, such as "a heartbreak ballad about summer". Use the result as lyrics in suno_generate with custom mode.

Permission: workflows:execute. Credits: 10.

ParameterTypeNotes
promptstringRequired. The theme, up to 1,000 characters.

Returns: a job id. The lyrics are in the job output, and the card shows them with a Copy button.

suno_style_boost

Turns a short style description, such as "lo-fi chill", into richer style tags. Use the result as style in suno_generate.

Permission: workflows:execute. Credits: 10.

ParameterTypeNotes
contentstringRequired. The style to enhance, up to 5,000 characters.

Returns: a job id. The improved style is in the job output.

suno_extend

Continues a song made with Suno.

Permission: workflows:execute. Credits: 30.

ParameterTypeNotes
audio_asset_idstringRequired. The Nodaro job id of the Suno song.
continue_atnumberThe second of the song where the extension starts.
prompt, style, titlestringSteer the extension.
vocal_genderstringmale or female.
modelstringV6 (default) or another Suno version.

Returns: a job id.

suno_upload_extend

Continues a track that was not made with Suno, from a public URL. For a Suno song, use suno_extend.

Permission: workflows:execute. Credits: 30.

ParameterTypeNotes
audio_urlstringRequired. The public URL of the track.
continue_atnumberRequired. The second where Suno continues.
style, negative_style, title, vocal_gender, modelAs on suno_generate.
use_default_paramsbooleanUses Suno's defaults instead of your style and title. Default false.

Returns: a job id.

suno_cover

Makes a cover of a track: the same melody and lyrics in a new musical style. The source can be any Nodaro audio, not only a Suno song.

Permission: workflows:execute. Credits: 30.

ParameterTypeNotes
promptstringRequired. The style of the cover, up to 5,000 characters.
audio_url or audio_asset_idstringThe source track.
instrumentalbooleanAn instrumental cover, without vocals.
lyricsstringNew lyrics. Without them, Suno reuses the lyrics it hears in the source.
custom_mode, style, title, vocal_gender, modelAs on suno_generate.

Returns: a job id. Only cover audio you own; the song-from-reference recipe explains how to make a similar song from someone else's track. See Content recipes.

suno_mashup

Blends two tracks into a mashup.

Permission: workflows:execute. Credits: 30.

ParameterTypeNotes
audio_url_1 or audio_asset_id_1stringThe first track.
audio_url_2 or audio_asset_id_2stringThe second track.
custom_mode, style, negative_style, title, vocal_genderAs on suno_generate.

Returns: a job id.

suno_replace_section

Generates one part of a Suno song again, and keeps the rest.

Permission: workflows:execute. Credits: 20.

ParameterTypeNotes
audio_asset_idstringRequired. The Nodaro job id of the Suno song.
infill_start_s, infill_end_snumberRequired. The part to replace, in seconds. It must last 6 to 60 seconds and at most half of the song.
promptstringRequired. What the new part should contain, up to 5,000 characters.
tagsstringRequired. Style tags for the new part, up to 500 characters.
negative_tagsstringStyles to keep out of the new part.
full_lyricsstringThe lyrics of the whole song after the change, both changed and unchanged parts.
titlestringUp to 80 characters.

Returns: a job id.

suno_add_vocals

Adds vocals to a Suno instrumental.

Permission: workflows:execute. Credits: 30.

ParameterTypeNotes
audio_asset_idstringRequired. The Nodaro job id of the Suno instrumental.
modelstringV6 (default), V6_WILD, V6_MINI, V4_5PLUS, V5 or V5_5.

Returns: a job id.

suno_add_instrumental

Adds an instrumental layer to a Suno song.

Permission: workflows:execute. Credits: 30.

ParameterTypeNotes
audio_asset_idstringRequired. The Nodaro job id of the Suno song.
modelstringV6 (default), V6_WILD, V6_MINI, V4_5PLUS, V5 or V5_5.

Returns: a job id.

suno_separate_stems

Splits a Suno song into vocals and instrumental, or into a stem for each instrument. It works only on songs made with Suno; for other audio, use separate_audio.

Permission: workflows:execute. Credits: 40.

ParameterTypeNotes
audio_asset_idstringRequired. The Nodaro job id of the Suno song.
typestringseparate_vocal (default) for vocals and instrumental, or split_stem for every instrument.

Returns: a job id.

suno_convert_wav

Converts a Suno song to a lossless WAV file.

Permission: workflows:execute. Credits: 10.

ParameterTypeNotes
audio_asset_idstringRequired. The Nodaro job id of the Suno song.

Returns: a job id.

suno_music_video

Makes an MP4 music video from a Suno song. The pictures come from the audio, and there is no style or prompt to set. It works like the Music Video node.

Permission: workflows:execute. Credits: 10.

ParameterTypeNotes
audio_asset_idstringRequired. The Nodaro job id of a Suno song. Songs from other models, such as MiniMax or ElevenLabs, cannot be used.

Returns: a job id.

Frequently asked questions

Last updated on

On this page